## development

  - Add your change HERE

## 2.25.0
  - Generator for Finnish identity numbers [@zHarrowed]
  - Fix typos and add Codespell GitHub action [@kianmeng]
  - Add FFaker::Boolean.boolean with true ratio [@nedzib]
  - Add LoremTW and JobTW [@cookiepingyen]
  - Add loan tools to bank [@hulous]

## 2.24.0
  - *BREAKING CHANGE*: Drop support under ruby 3.0 [@marocchino]
  - Add ruby 3.4 to CI [@marocchino]
  - Add ruby 3.3 to CI [@boimw]
  - Fix Luhn algorithm used in french companie's SIRET and sweden SSN [@Krap]
  - Add `FFaker::UUID` `.uuidv4`, `.uuidv6`, `.uuidv7`, and `.uuidv8` [@stilist]
  - Deprecate `FFaker::Guid.guid` in favor of `FFaker::UUID` methods [@stilist]
  - Limit FFaker::BankUS.routing_number first two digits [@professor]

## 2.23.0
  - Add FFaker::BankUS.accounting_number [@professor]
  - Add FFaker::BankUS.routing_number [@professor]
  - Resolve a lot of RuboCop offenses [@AlexWayfer]
  - Change `Image.url`, `Image.file`, `Book.cover` and `Avatar.image` arguments to keywords [@AlexWayfer]
  - Adds FFaker::Date.birthday [@professor]
  - Adds FFaker::Crypto.sha256 [@professor]
  - Update README [@professor]
  - Adds FFaker::Number.between [@professor]
  - Fixed `FFaker::Number.unique.number(digits: 1)` under Ruby 3 [@simonhildebrandt]

## 2.22.0
  - *BREAKING CHANGE*: Drop support under ruby 2.7 [@marocchino]
  - Correct Vehicle::VIN result [@philippevezina]
  - Improve performance unique [@iiwo]
  - Drop gemspec generation in rake [@technicalpickles]
  - Add identification EC [@josieljunior]
  - Update data for AddressDE [@slowjack2k]
  - Add ruby 3.2 to CI [@petergoldstein]
  - Add JoJo module [@ar2em1s]
  - Fix crash in FFaker::Time#datetime when defining FFaker::Date module [@brupla6126]

## 2.21.0
  - Generate valid VINs [@xunker]
  - Add neighborhood and address complement to AddressBR [@az3vedo]
  - Ensure FFaker::HTMLIpsum.fancy_string return includes at least one tag [@gabrielcosta42]
  - Fix IdentificationTW area code [@timfanda35]
  - Add Ruby 3.1 to CI matrix [@petergoldstein]
  - Add AnimalBr [@thiago-henrique-leite]
  - Fix rubocop warnings [@mmrshk]
  - Consistently generate REFERENCE.md [@technicalpickles] and [@Volosh1n]

## 2.20.0
  - Remove date from gem specification [@AlexWayfer]
  - Add Number module [@Volosh1n]
  - Make Italian Phone number deterministic [@Volosh1n]

## 2.19.0
  - Added Lorem BR [@abnersajr]
  - Added french company siret and siren generator [@hulous]
  - Added Games generator [@nicholaskillin]
  - Added EditorConfig file [@AlexWayfer]
  - Fixed loadError on scripts/reference.rb [@marocchino]
  - Removed trailing comma from NameGA first_names_male [@stilist]
  - Localized Gender and Sport to Russian [@SteveRedka]
  - Added more italian data [@miscelatore]

## 2.18.0
  - Remove unneeded 'require' statements [@Volosh1n]
  - Add PhoneNumberJA [@YutaGoto]
  - Test with Github actions & Ruby 3 [@marocchino]
  - Generate reference by CI [@marocchino]
  - Change the regex to cover all scenarios in lorem_fr [@abnersajr]
  - Add "Freedom Ipsum" text generator option [@hmaack] and [@lynnd335]
  - Fix issues with `FFaker::Image` module [@hmaack]
  - Fix typo in animal.rb module [@renius]

## 2.17.0
  - Apply Rubocop's autocorrect [@marocchino]
  - Remove Ruby-2.4 support [@marocchino]
  - Remove OpenStruct [@Volosh1n]
  - Fix PhoneNumberBR Area Codes [@CarlosMouraJR]
  - More minor fixes [@marocchino]

## 2.16.0
  - Add IdentificationIN [@nigelgomesot]
  - Improved NL zipcode generation [@gerard76]

## 2.15.0
  - Add `IdentificationTW` [@pominx]
  - Add `CompanyJA` [@ktroutner]
  - Add `AddressFR.region` [@GuillaumeOcculy]
  - Add `AnimalES` [@delucas]
  - Fix `AddressNL.postal_code` [@gerard76]

## 2.14.0
  - Add `Code.npi` [@alibby]

## 2.13.0
  - Add `Bank.card_number`, `.card_expiry_date` and `.card_type` [@AlexWayfer]
  - Add `Bank.iban` [@Volosh1n]
  - Add optional argument to `AddressUS.state_abbr` to determine state's abbreviation [@Volosh1n]
  - Add `Name.pronouns` [@danderozier]
  - Add `FFaker::ColorPL`, `FFaker::IdentificationPL`, `FFaker::SportPL` [@walerian777]

## 2.12.0
  - Add Russian Phone Numbers [@steverovsky]
  - Remove invalid example from NameRU.first_name_male [@steverovsky]
  - *BREAKING CHANGE*: Drop support of under 2.3  [@marocchino]
  - Add PhoneNumberUA [@Volosh1n]
  - Add SemVer [@marocchino]
  - Remove some obselated prefix from PhoneNumberBR.mobile_phone_prefix
    [@Kutomore]
  - Add Book.iban [@Volosh1n]
  - Add Name.pronouns [@danderozier]
  - Add PhoneNumberRU [@steverovsky]

## 2.11.0
  - Add HealthcareRU [@gruz0]
  - Removing potentially offensive name [@rvisuvasam]
  - Add NameTW, PhoneNumberTW [@pominx]
  - Add AnimalCN, EducationCN [@ckyOL]
  - Add NameIN [@alagu]
  - Add AnimalPL, GenderPL, GenderJP, PhoneNumberPL [@walerian777]
  - Now PhoneNumberBR returns only valid area_code

## 2.10.0
  - Add Image [@nicolas-brousse]
  - Add LoremPL (Polish) [@walerian777]
  - Add NameES (Spainsh) [@rgcamus]
  - Fix DateTime range [@AlexWayfer]
  - Now SSN returns valid SSN [@lilsweetcaligula]
  - Now FFaker::Time.(date, datetime) returns Date, DateTime objects [@AlexWayfer]
  - Now Gender.random returns non-binary genders [@kmayer]
    - If you need binary gender use Gender.binary

## 2.9.0
  - Add orly book cover generator [@artplan1]
  - Add LoremIE (Irish) [@mklemme]
  - Improve FFaker::Time.between docs and implementation [@eikes]
  - Fix patronymics for Никита [@ulzr]
  - Add EAN generator [@jvanbaarsen]

## 2.8.1
  - Updated password generation [@makketagg]

## 2.8.0
  - Fixes `Uncaught exception: invalid byte sequence in US-ASCII` [@thilonel]
  - Add international numbers on PhoneNumberFR and test it [@nicolas-brousse]
  - Clean code based on PhoneNumberBR structure [@nicolas-brousse]
  - Drop support for ruby 1.9 [@thilonel]
  - Replace mass require with autoload [@thilonel]

## 2.7.0
  - Add unique method [@AlexAvlonitis]
  - Add Time.day_of_week [@tvarley]
  - Add CompanyIT.partita_iva [@aaronsama]

## 2.6.0
  - Add Polish names [@walerian777]
  - Add Polish addresses [@walerian777]
  - Add full_address to Brazilian addresses [@adimircolen]
  - Add Filesystem [@j0al]
  - Add Aminal [@ni3t]
  - Fix PhoneNumberAU mobile number [@spheric]

## 2.5.0
  - Support Arabic names [@Moafak]
  - Add Japanese address [@kojino]
  - Add more Brazilian city [@jasonleonhard]
  - Now PhoneNumber#ime returns valid IMEIs [@metalelf0]

## 2.4.0
  - Support Indonesia names, address, phone & gender [@brain64bit]
  - Support Russian lorem [@mechos3d]
  - Fix AddressAU#time_zone: will return AU time zone now [@tatey]

## 2.3.0
  - Make deterministic / repeatedly random using seed [@xunker]
  - Fix DE and NL address modules [@dankimio]
  - Refactor HTMLIpsum module [@rocknruby]
  - Stricter exchange code in US phone number [@MQuy]
  - Add AWS module [@joshdvir]
  - Add hexcode to Color module [@thutterer]
  - Add CPF/CPFJ to Brazilian identification module [@thutterer]
  - Add MAC address to Internet module [@pawelma]
  - Add rgb, rgba, hsl, hsla to Color module [@dphurley]
  - Add html safe names to Name module [@dimroc]
  - Add mode education degrees to Education module [@dimroc]
  - Add datetime to Time module [@waldyr]
  - Add between to Time module [@brnrdog]
  - Add Airline module [@jakubm]
  - Add Sport module [@iamarmanjon]
  - Add Youtube module [@andyklimczak]
  - Add Tweet module [@tvarley]
  - Add Korean address module [@marocchino]
  - Add Greek name module [@falegk]
  - Add Greek address module [@falegk]
  - Add Brazilian name module [@Sephyros]
  - Add Vietnam job module [@vinhnglx]
  - Add Chinese company module [@robin]
  - Add Thai name module [@firedev]
  - Add Japanese lolem module [@44uk]
  - Add Book module [@max-si-m]
  - Add gender option to Brazilian name module [@IgorMarques]
  - Add Brazilian gender module [@IgorMarques]
  - Add gender option to English name module [@nav16]
  - Add Brazilian identification module [@IgorMarques]
  - Add Brazilian job module [@IgorMarques]
  - Add Cambodian name module [@Phanithism]

## 2.2.0
  - fixes some bugs
    - generating Robohash images

  - many new improvements and enhancements like:
    - CheesyLingo
    - Music module
    - Brazilian phones
    - Improve NameJA
    - added AddressRU

## 2.1.0

  - [#191] - add REFERENCE.md ([@rstacruz])
  - [#193] - fix FFaker::Locale.language throwing errors ([@rstacruz], [#196])
  - [#199] - FFaker::String.from_regexp: implement support for regexp ranges like `/[a-f]/` ([@marocchino], [#200])
  - [#181] - fix FFaker::PhoneNumber.phone_number throwing invalid US phone numbers ([@rstacruz], [#195])
  - [#181] - implement FFaker::PhoneNumber.area_code ([@rstacruz], [#195])
  - [#203] - deprecate FFaker::ArrayUtils.random_pick in favor for Array#sample ([@marocchino])
  - [#211] - add Korean identification support
  - [#212] - add IMEI support
  - [#213] - Fix max length support FFaker::Internet.password ([@anderscarling])
  - many internal library and test suite refactorings



## 2.0.0
  - switched faker to ffaker namespace, you should now be able to use
  faker and ffaker gem together.

## 1.32.1
  - set required ruby version for gem

## 1.32.0
  - add Korean lorem to API
  - add 100 canadian largest cities to API
  - add Cuban phone numbers to API
  - add currency code to API
  - internal code-style improvements

## 1.31.0

  - add deprecation warning to ArrayUtils#rand method
  - changed all internal ArrayUtils#rand method calls to Array#sample
  - Korea API additions
  - fixes some broken tests


## 1.30.0

  - dropped support for ruby 1.8.x
  - fixes some broken tests
  - improved Faker::Internet.slug method
  - added Faker::Gender(CN), Faker::Guid to API
  - added continental_state and continental_state_abbr to Faker::AddressUs API
  - added Faker::Internet.safe_email method to API
  - added max_length parameter to Faker::Internet.password
  - and some small API additions ... for more details check the git log

## 1.25.0

API additions and some fixes... check the git log! :)

## 1.24.0

API additions

## 1.23.0

API additions

## 1.22.1

Bugfixes and minor API additions.

## 1.22.1

Bugfixes

## 1.22.0

Maintenance release, lots of cleanups.
New modules contributed.

## 1.21.0

NameFR

Skill

Unit

UnitEnglish

UnitMetric

## 1.20.0

JobFR

LoremFR

## 1.19.0
More APIs

## 1.16.2
Small bug fix and updated docs.

## 1.16.1
Fixes for ruby 1.8.x

## 1.16.0
Many module additions from different contributors!

## 1.15.0
NameKR (https://github.com/ffaker/ffaker/pull/47) and PhoneNumbersSG
(https://github.com/ffaker/ffaker/pull/46).

## 1.14.0

AddressSN (thanks PapePathe), and a bugfix on FFaker::Product.model (thanks finarfin).

## 1.13.0

Education bug fix, FFaker::Job (thanks Piotr Usewicz)

## 1.12.0

FFaker::AddressAU and FakkerAddressPhoneAU modules (thanks Ben Wiseley).

## 1.11.0

Extraction of AddressUK and AddressUS classes. (Thanks doctorbh).

## 1.10.1

FFaker::AddressCA (Thanks doctorbh, https://github.com/ffaker/ffaker/pull/27)

## 1.9.1

FFaker::NameSN, FFaker::PhoneNumberSN (Thanks SENE, https://github.com/ffaker/ffaker/pull/26)

Added FFaker::NameJA (Thanks kichiro, https://github.com/ffaker/ffaker/pull/21)

## 1.8.1

Remove a warning.

## 1.8.0

FFaker::HTMLIpsum module inspired in http://html-ipsum.com/ (Thanks Chris Bloom, https://github.com/ffaker/ffaker/pull/18)

## 1.7.0

FFaker::LoremCN (Thanks Shane Weng, Shane Weng, https://github.com/swcool, https://github.com/ffaker/ffaker/pull/16/files)

## 1.6.0

FFaker::NameDE (thanks David Noelte, https://github.com/marvin, https://github.com/ffaker/ffaker/pull/17)
Added FFaker::Internet#disposable_email (Thanks Port 80 Labs, https://github.com/port80labs, https://github.com/ffaker/ffaker/pull/15)

## 1.5.0

FFaker::NameRU (Thanks Vsevolod Romashov, https://github.com/7even, https://github.com/ffaker/ffaker/pull/14)

## 1.4.0

FFaker::Product and FFaker::Education (thanks Rico Sta. Cruz, https://github.com/ffaker/ffaker/pull/12 )

## 1.3.0

FFaker::Lorem.word as a convenience method, instead of FFaker::Lorem.words(1).first.

## 1.2.0

New FFaker::NameCN module (contributions by qichunren)

  FFaker::NameCN.first_name # => 鑫洋
  FFaker::NameCN.last_name # => 禹
  FFaker::NameCN.name # => 俊伶漫

## 1.1.0

Api additions (contributions by Robert Berry)

  FFaker::Internet.uri(protocol)
  FFaker::Internet.http_url
  FFaker::Internet.ip_v4_address

## 0.4.0

Api additions by Rafael Souza

  FFaker::Geolocation.lat # => 40.6609944585817
  FFaker::Geolocation.lng # => -73.8454648940358
  FFaker::Address.neighborhood # => "Renton West"


## 0.3.3 2010-01-14

* removed library file and directory "faker". now you only can load the gem using require 'ffaker'

## 0.3.2 2010-01-14

* Several Optimizations, renamed gem package to ffaker.

## 0.3.1 2008-04-03

1 minor enhancement:

* Added city to Address

## 0.3.0 2008-01-01

3 major enhancements:

* Added Lorem to generate fake Latin
* Added secondary_address to Address, and made inclusion of secondary address in street_address optional (false by default).
* Added UK address methods [Caius Durling]

## 0.2.1 2007-12-05

1 major enhancement:

* Dropped facets to avoid conflict with ActiveSupport

2 minor enhancements:

* Changed the output of user_name to randomly separate with a . or _
* Added a few tests

## 0.1.0 2007-11-22

* Initial release

[#181]: https://github.com/ffaker/ffaker/issues/181
[#191]: https://github.com/ffaker/ffaker/issues/191
[#193]: https://github.com/ffaker/ffaker/issues/193
[#195]: https://github.com/ffaker/ffaker/issues/195
[#196]: https://github.com/ffaker/ffaker/issues/196
[#199]: https://github.com/ffaker/ffaker/issues/199
[#200]: https://github.com/ffaker/ffaker/issues/200
[#203]: https://github.com/ffaker/ffaker/issues/203
[#211]: https://github.com/ffaker/ffaker/pull/211
[#212]: https://github.com/ffaker/ffaker/pull/212
[#213]: https://github.com/ffaker/ffaker/pull/213
[@44uk]: https://github.com/44uk
[@AlexAvlonitis]: https://github.com/AlexAvlonitis
[@AlexWayfer]: https://github.com/AlexWayfer
[@CarlosMouraJR]: https://github.com/CarlosMouraJR
[@GuillaumeOcculy]: https://github.com/GuillaumeOcculy
[@IgorMarques]: https://github.com/IgorMarques
[@Krap]: https://github.com/Krap
[@Kutomore]: https://github.com/Kutomore
[@MQuy]: https://github.com/MQuy
[@Moafak]: https://github.com/Moafak
[@Phanithism]: https://github.com/Phanithism
[@Sephyros]: https://github.com/Sephyros
[@SteveRedka]: https://github.com/SteveRedka
[@Volosh1n]: https://github.com/Volosh1n
[@YutaGoto]: https://github.com/YutaGoto
[@aaronsama]: https://github.com/aaronsama
[@abnersajr]: https://github.com/abnersajr
[@adimircolen]: https://github.com/adimircolen
[@alagu]: https://github.com/alagu
[@alibby]: https://github.com/alibby
[@anderscarling]: https://github.com/anderscarling
[@andyklimczak]: https://github.com/andyklimczak
[@ar2em1s]: https://github.com/ar2em1s
[@artplan1]: https://github.com/artplan1
[@az3vedo]: https://github.com/az3vedo
[@boimw]: https://github.com/boimw
[@brain64bit]: https://github.com/brain64bit
[@brnrdog]: https://github.com/brnrdog
[@brupla6126]: https://github.com/brupla6126
[@ckyOL]: https://github.com/ckyOL
[@cookiepingyen]: https://github.com/cookiepingyen
[@danderozier]: https://github.com/danderozier
[@dankimio]: https://github.com/dankimio
[@delucas]: https://github.com/delucas
[@dimroc]: https://github.com/dimroc
[@dphurley]: https://github.com/dphurley
[@eikes]: https://github.com/eikes
[@falegk]: https://github.com/falegk
[@firedev]: https://github.com/firedev
[@gabrielcosta42]: https://github.com/gabrielcosta42
[@gerard76]: https://github.com/gerard76
[@gruz0]: https://github.com/gruz0
[@hmaack]: https://github.com/hmaack
[@hulous]: https://github.com/hulous
[@iamarmanjon]: https://github.com/iamarmanjon
[@iiwo]: https://github.com/iiwo
[@j0al]: https://github.com/j0al
[@jakubm]: https://github.com/jakubm
[@jasonleonhard]: https://github.com/jasonleonhard
[@joshdvir]: https://github.com/joshdvir
[@josieljunior]: https://github.com/josieljunior
[@jvanbaarsen]: https://github.com/jvanbaarsen
[@kianmeng]: https://github.com/kianmeng
[@kmayer]: https://github.com/kmayer
[@kojino]: https://github.com/kojino
[@ktroutner]: https://github.com/ktroutner
[@lilsweetcaligula]: https://github.com/lilsweetcaligula
[@lynnd335]: https://github.com/lynnd335
[@makketagg]: https://github.com/makketagg
[@marocchino]: https://github.com/marocchino
[@max-si-m]: https://github.com/max-si-m
[@mechos3d]: https://github.com/mechos3d
[@metalelf0]: https://github.com/metalelf0
[@miscelatore]: https://github.com/miscelatore
[@mklemme]: https://github.com/mklemme
[@mmrshk]: https://github.com/mmrshk
[@nav16]: https://github.com/nav16
[@ni3t]: https://github.com/ni3t
[@nicholaskillin]: https://github.com/nicholaskillin
[@nicolas-brousse]: https://github.com/nicolas-brousse
[@nigelgomesot]: https://github.com/nigelgomesot
[@pawelma]: https://github.com/pawelma
[@petergoldstein]: https://github.com/petergoldstein
[@philippevezina]: https://github.com/philippevezina
[@pominx]: https://github.com/pominx
[@professor]: https://github.com/professor
[@renius]: https://github.com/renius
[@rgcamus]: https://github.com/rgcamus
[@robin]: https://github.com/robin
[@rocknruby]: https://github.com/rocknruby
[@rstacruz]: https://github.com/rstacruz
[@rvisuvasam]: https://github.com/rvisuvasam
[@simonhildebrandt]: https://github.com/simonhildebrandt
[@slowjack2k]: https://github.com/slowjack2k
[@spheric]: https://github.com/spheric
[@steverovsky]: https://github.com/steverovsky
[@stilist]: https://github.com/stilist
[@tatey]: https://github.com/tatey
[@technicalpickles]: https://github.com/technicalpickles
[@thiago-henrique-leite]: https://github.com/thiago-henrique-leite
[@thilonel]: https://github.com/thilonel
[@thutterer]: https://github.com/thutterer
[@timfanda35]: https://github.com/timfanda35
[@tvarley]: https://github.com/tvarley
[@ulzr]: https://github.com/ulzr
[@vinhnglx]: https://github.com/vinhnglx
[@waldyr]: https://github.com/waldyr
[@walerian777]: https://github.com/walerian777
[@xunker]: https://github.com/xunker
[@zHarrowed]: https://github.com/zHarrowed