.random_sample()
now returns a list of unique elements instead of a set..random_sample_unique()
is removed in favor of.random_sample()
.- Added
random_choices()
,random_elements()
andrandom_letters()
. - Added
faker.utils.distribution.choices_distribution_unique()
. words()
,password()
,uri_path
andpystr()
now use the new therandom_choices()
method.
- Change blood group from
0
(zero) toO
(capital letter O). Some locales do use 'zero', butO
is more common and it is the medical standard. Thanks @mohi7solanki. - Fix alpha-2 country code for Haiti. Thanks @sevens-ef for the report.
- Fix abbreviation for Nunavut. Thanks @straz for the report.
- Standardized
postcode
in address providers. Now all locales are guaranteed to have apostcode
method and may have a localized alias for it (eg:zipcode
). Thanks @straz for the report. - Fix typo in
pt_BR
Person perovider. Thanks @Nichlas. - Fix timezone handling. Thanks @Fraterius.
- Use tzinfo when provided in
date_of_birth
. Thanks @Kelledin.
- Add
ein
,itin
and refactoredssn
Provider foren_US
. Thanks @crd. - Add
job
provider forzh_CN
. Thanks @ramwin. - Add
date_of_birth
provider. Thanks @cdr. - Add alpha-3 representation option for
country-code
provider. Thanks @cdr.
- Fix test for CPF (Brazilian SSN). Thanks Rubens Takiguti Ribeiro.
- Fix Canadian SIN generation. Thanks @crd.
- Fix Norwegian SSN date portion. Thanks @frangiz.
- Add
start_datetime
argument forunix_time()
. Thanks @crd.
- Change logging level to
DEBUG
.
- Add possibility to make artificial ssn numbers for
FI_fi
. Thanks @kivipe. - Update
ko_KR
person data based on statistics. Thanks @unace. - Improved logging. Thanks @confirmationbias616.
- Add
no_NO
bank provider. Thanks @cloveras. - Add
ipv4_network_class
,ipv4_private
,ipv4_public
providers. Thanks @ZuluPro. - Add
address_class
andprivate
arguments toipv4
provider. Thanks @ZuluPro. - Add
currency
,currency_name
,cryptocurrency
,cryptocurrency_code
andcryptocurrency_name
to currency provider. Thanks @ZuluPro. - Add automotive provider for
de_DE
. Thanks @gsilvan. - Fix edgecases for Finnish
ssn
provider. Thanks @sanga. - Add job provider for
pt_BR
. Thanks @paladini. - Add
unix_device
andunix_partition
tofile
provider. Thanks @ZuluPro. - Add
random_lowercase_letter
andrandom_uppercase_letter
to the base provider. Thanks @ZuluPro. - Clarify CLI help. Thanks @confirmationbias616.
- Fix issue with
cx_Freeze
. Thanks @sedominik. - Add dutch
nl_NL
bank provider. Thanks @PatSousa. - Add
distrito
andfreguesia
topt_PT
address
provider. Thanks @ZuluPro. - Fix unicode issues with the
person
provider. Thanks @karthikarul20. - Add
en_SG
person
provider. Thanks @karthikarul20. - Add street names to the Ukrainian address provider. Thanks @cadmi.
- Add
de_AT
address provider. Thanks @bessl. - Fix credit card prefixes. Thanks @jphalip.
- Fix capitalization in
no_NO
address provider. Thanks @cloveras. - Fix deprecated syntax for raw strings. Thanks @dchudz.
- Add
latitude
andlongitude
tode_AT
address
provider. Thanks @bessl. - Fix incorrect value in list of middle name for locale
ru_RU
. Thanks @damirazo.
- Add scheme selection for internet
url
provider. Thanks @ProvoK. - Increase lower bound on AD date generation. Thanks @prophile.
- Add the ability to specify the min and max age for some ssn locales. Thanks @frangiz.
- Pass
python_requires
argument tosetuptools
. Thanks @jdufresne. - Remove some words from
en_US
lorem ipsum provider. Thanks @Pomax.
- Remove support for Python 3.3. Thanks @jdufresne.
- Allow past dates within a second. Thanks @DanEEstar.
- Added phone number formatting to
en_GB
localisation to ensure no genuine phone numbers are generated. Thanks @TheSapper. - Added
en_GB
localisation for SSN (UK National Insurance Number). Thanks @TheSapper. - Added
ro_RO
person Provider. Thanks @vasilesmartup. - Added
domain
argument toemail
provider. Thanks @lcd1232.
- made
seed_instance
returnself
for chainability. - Add
en_US
locale forlorem
. Thanks @shacker. fi_FI
gender specific data added. Thanks @mikkhola.fi_FI
address and job lists updated. Thanks @mikkhola.- Add
iban
provider. Thanks @cdaller.
- Corrected some issues with the Hungarian (
hu_HU
) providers, such as incorrectly capitalized company suffixes, street/road type names and place names. Thanks @chrisvoncsefalvay. - The Hungarian locale's
providers.job.job
provider now returns Hungarian job names, taken from the Hungarian National Statistical Office (KSH)'s 2008 survey nomenclature of employment (FEOR '08). Thanks @chrisvoncsefalvay. - Added
he_IL
locale. Thanks @bjesus. - Fix possible infinite loop in
random_sample_unique
. Thanks @153957. - Add aliases to make
pt_BR
address provider compatiblewith en_US
. Thanks @diegoholiveira. - Fix ResourceWarning in
setup.py
. Thanks @jdufresne. - Update test requirements.
- Replace
unidecode
dependency in favor oftext-unidecode
. Faker now requires text-unidecode.
- Add ASCII emails. Thanks @barseghyanartur.
- Add
id_ID
Providers. Thanks Sidi Ahmad. - Fix
date_time.time_series()
to ensure start and end bounds are inclusive. Thanks @bijanvakili. - Create a provider to Brazilian license plates. Thanks @diegoholiveira.
- Use a proper international format for Ukrainian phone numbers. Thanks @illia-v.
- Faker now requires Unidecode.
- Move
email_validator
totest_requires
and unpinned the version number. - Date feature parity with datetime. Thanks @noirbizarre.
- Add
MSISDN
in thephone_number
provider. Thanks @patrickporto. - Add Arabic locales. Thanks @ahmedaljazzar.
- Fix datetime issue on Windows. Thanks @kungfu71186.
- Fix release build.
- Revert name change of
faker.generator.random
. Thanks @adamchainz. - Document the global shared
random.Random
andseed_instance()
. Thanks @adamchainz.
- Rolled back breaking change in
randomize_nb_elements
.
- Add
identity_card_number
forpl_PL
person
provider. Thanks @pdaw. - More descriptive error message when a formatter is not found. Thanks @fcurella.
- Add
time_series
provider. Thanks @fcurella. - Add per-instance seeding via
.seed_instance
method. Thanks @reverbc. - Fix
tz_TW
address
provider. Thanks @clarmso.
- Generate proper dates before 1970. Thanks @kungfu71186.
- Made it possible to seed
.binary()
. Thanks @kungfu71186. - Add color names for
hr_HR
. Thanks @mislavcimpersak. - Add implementation of
ssn
provider for thepl_PL
locale. Thanks @pdaw. - Add
pt_BR
colors localization. Thanks @ppcmiranda. - Create a method for codes of cryptocurrencies in the currency provider. Thanks @illia-v.
- Fix female name format typo in
hu_HU
person provider. Thanks @swilcox. - Fix deprecated usage of
print
statement in README. Thanks @cclauss. - Add gender-specific names for
sv_SE
person provider. Thanks @swilcox. - Add an implementation of regon for
pl_PL
company provider. Thanks @pdaw. - Addi an implementation of
local_regon
forpl_PL
company provider. Thanks @pdaw. - Replace deprecated
getargspec
on py3. Thanks @fcurella. - Add new
automotive
provider. Thanks @zafarali. - Add an implementation of
company_vat
forpl_PL
company provider. Thanks @pdaw. - Add Taiwan/Traditional character support for internet and lorem providers. Thanks @bearnun.
- Use
random.choices
when available for better performance. Thanks @catleeball. - Refactor RGB color methods. Thanks @catleeball.
- Fix a timezone issue with the
date_time_between_dates
provider.
- fix timezone issues with
date_time_between
provider. - Add
ext_word_list
parameter to methods in the Lorem generator. Thanks @guinslym.
- fix start and end date for datetime provider methods.
- fix
future_date
, and ``past_date` bounds.
- Remove capitalisation from
hu_HU
addresses. Thanks @Newman101. - Add
et_EE
(Estonian) provider: names and ssn. Thanks @trtd. - Proper prefix for gender in
pl_PL
names. Thanks @zgoda. - Add DateTime provider for
pl_PL
. Thanks @zgoda. - Add
pl_PL
internet data provider. Thanks @zgoda. - Fix diacritics in
pl_PL
street names. Thanks @zgoda. - Add
future_date
,future_datetime
,past_date
andpast_datetime
to DateTime Provider
- Add Japanese lorem provider. Thanks @richmondwang.
- Add hr_HR names of month and names of days. Thanks @mislavcimpersak.
- Add sl_SI names of month and names of days. Thanks @mislavcimpersak.
- Update the provider
user_agent
. Thanks @illia-v. - Add russian words for date_time. Thanks @iskhomutov.
- Add Georgian (
ka_GE
) person and address providers. Thanks @GeorgeLubaretsi. - Add company provider to hu_HU locale. Thanks @Newman101.
- Allow subdomains for
domain_name
provider. Thanks @hiagofigueiro. - Implement hu_HU months + days. Thanks @Newman101.
- Replacement rules for emails à->a, è->e in de_DE internet provider. Thanks @Bergil32.
- Added french words for days and months. Thanks @sblondon.
- Reorganized tests. Thanks @grantbachman.
- Added file path provider. Thanks @diegommarino.
- Fixed packaging issue with tests module. Thanks @eukreign for the report.
- Add ISBN-10 and ISBN-13. Thanks @grantbachman.
- Add colors for fr_FR. Thanks @sblondon.
- Fix packaging isssue. Thanks @jorti.
- Add a Russian language to color provider. Thanks @kotyara1005.
- Correct UnboundLocalError in Finnish SSN generator. Thanks @lamby.
- Create internet IT provider. Thanks @GlassGruber.
- Add fix_len parameter to 'random_number'. Thanks @vlad-ki.
- Support zh_CN lorem. Thanks @yihuang.
- Customize chinese word connector. Thanks @yihuang.
- Add more company data to fa_IR. Thanks @aminalaee.
- Python 3.6 support. Thanks @stephane.
- Add hu_HU providers. Thanks @chrisvoncsefalvay.
- Fix tests failures.
- Fix no_NO postcodes. Thanks @kdeldycke.
- Fix fa_IR city generator. Thanks @kdeldycke.
- Fix packaging issue with docs directory. Thanks @wyattanderson.
- Deprecate
facke-factory
package on PyPI.
- Add Ukrainian
address
provider. Thanks @illia-v. - Add Ukrainian
internet
provider. Thanks @illia-v. - Middle name support for
person.ru_RU
provider. Thanks @zeal18. - Add
address
,company
,internet
ansSSN
provider forru_RU
. Thanks @zeal18. - Improved
address.pl_PL
provider. Thanks @pkisztelinski. - Add date and time object providers. Thanks @jtojnar.
- Refactor Korean address methods. Thanks @item4.
- Add provider for locale nl_BE (address, phone, ssn). Thanks @vema.
- Add additional job titles. Thanks @wontonst.
- Add Ukrainian color provider. Thanks @illia-v.
- Add support to brazilian company IDs (CNPJ). Thanks @lamenezes.
- Improve the Internet provider. Thanks@illia-v.
- Improve the Ukrainian person provider. Thanks @illia-v.
- Improve some SSN providers. Thanks @illia-v.
- Improve code samples in README.rst and docs/index.rst. Thanks @illia-v.
- Improve the method locale. Thanks @illia-v.
- Fix pyfloat. Thanks @illia-v.
- Allow left/right_digits=0 for pyfloat. Thanks @mnalt.
- update fa_IR person names and phone numbers. Thanks @aminalaee.
date_time_this_century
now returnsdatetime
s outside the current decade. Thanks @JarUrb.- Add support for localized jobs for
hr_HR
. Thanks @mislavcimpersak. - Adding support for Croatian
hr_HR
ssn (oib). Thanks @mislavcimpersak. - Rename PyPI package to
Faker
.
- Dropped Python 2.6 support
- Add optional parameter sex to profile and simple_profile. Thanks @navyad.
- Fix whitespace in dk_DK provider last_names/last_name. Thanks @iAndriy.
- Fix utf8 coding issue with
address/fi_FI
provider. Thanks @delneg. - ! Latest version to support Python 2.6
- Fix random_sample_unique. Thanks @cecedille1.
- Add more
pt_BR
names. Thanks @cuducos. - Added
en_GB
names. Thanks @jonny5532. - Add romanized internet provider for
zh_CN
. - Add
fr_CH
providers. Thanks @gfavre.
- Improve CLI output and help. Thanks @cbaines.
- Update
en_US
anmes to be more realistic. Thanks @dethpickle. - Modify pystr provider to accept a minimum number of characters. Thanks @tamarbuta.
- Add job Provider for
zh_TW
. Thanks @weihanglo. - Modify
zh_TW
phone number for a more valid format. Thanks @weihanglo. - Reduce the maximum value of start timestamps. Thanks @cbaines.
- Add random_sample and random_sample_unique. Thanks @bengolder.
- Repackage to resolve PyPI issue.
- Add date handling for datetime functions. Thanks @rpkilby.
- Discern male and female first names in pt_BR. Thanks @gabrielusvicente.
- Specify help text for command line. Thanks @cbaines.
- Expose Provider's random instance. Thank @gsingers for the suggestion.
- Make sure required characters are in the password. Thanks @craig552uk.
- Add
internet
andjob
Providers forfa_IR
. Thanks @hamidfzm. - Correct Poland phone numbers. Thanks @fizista.
- Fix brittly tests due to seconds elapsed in-between comparison
- Allow unicode in emails and domains. Thanks @zdelagrange for the report.
- Use
dateutil
for computing next_month. Thanks @mark-love, @rshk. - Fix tests module import. Thanks @jorti for the report.
- Handle unexpected length in
ean()
. Thanks @michaelcho. - Add internet provider for
ja_JP
. Thanks @massa142. - Add Romanized Japanese person name. Thanks @massa142.
- Add tzinfo support to datetime methods. Thanks @j0hnsmith.
- Add an 'office' file extensions category. Thanks @j0hnsmith.
- Generate name according to profile's sex. Thanks @Dutcho for the report.
- Add
bs_BA
phone number and internet provider. Thanks @elahmo. - Add a SSN provider for
zh_CN
. Thanks @felixonmars. - Differentiate male and female first names in
fr_FR
locale. Thanks @GregoryVds - Add Maestro credit card. Thanks @anthonylauzon.
- Add
hr_HR
localization. Thanks @mislavcimpersak. - Update
de_DE
first names. Thanks @WarrenFaith and @mschoebel. - Allow generation of IPv4 and IPv6 network address with valid CIDR. Thanks @kdeldycke.
- Unittest IPv4 and IPv6 address and network generation. Thanks @kdeldycke.
- Add a new provider to generate random binary blob. Thanks @kdeldycke.
- Check that randomly produced language codes are parseable as locale by the factory constructor. Thanks @kdeldycke.
- Fix chinese random language code. Thanks @kdeldycke.
- Remove duplicate words from Lorem provider. Thanks @jeffwidman.
- Added
company_vat
to companyfi_FI
provider. Thanks @kivipe. - Seed a Random instance instead of the module. Thanks Amy Hanlon.
- Fixed en_GB postcodes to be more realistic. Thanks @mapleoin for the report.
- Fixed support for Python 3 in the python provider. Thanks @derekjamescurtis.
- Fixed U.S. SSN generation. Thanks @jschaf.
- Use environment markers for wheels. Thanks @RonnyPfannschmidt
- Fixed Python3 issue in
pyiterable
andpystruct
providers. Thanks @derekjamescurtis. - Fixed
en_GB
postcodes to be more realistic. Thanks @mapleoin. - Fixed and improved performance of credit card number provider. Thanks @0x000.
- Added Brazilian SSN, aka CPF. Thanks @ericchaves.
- Added female and male names for
fa_IR
. Thanks @afshinrodgar. - Fixed issues with Decimal objects as input to geo_coordinate. Thanks @davy.
- Fixed bug for
center
set toNone
in geo_coordinate. Thanks @davy. - Fixed deprecated image URL placeholder services.
- Fixed provider's example formatting in documentation.
- Added en_AU provider. Thanks @xfxf.
- Added
uuid4
tomisc
provider. Thanks Jared Culp. - Fixed
jcb15
andjcb16
incredit_card
provider. Thanks Rodrigo Braz. - Fixed CVV and CID code generation in credit_card provider. Thanks Kevin Stone.
- Added
--include
flag to command line tool. Thanks Flavio Curella. - Added
country_code
to address` provider. Thanks @elad101 and Tobin Brown.
- Fixed egg installation. Thanks David R. MacIver, @kecaps
- Updated person names for
ru_RU
. Thanks @mousebaiker. - Updated ko_KR locale. Thanks Lee Yeonjae.
- Fixed installation to install importlib on Python 2.6. Thanks Guillaume Thomas.
- Improved tests. Thanks Aarni Koskela, @kecaps, @kaushal.
- Made Person
prefixes
/suffixes
always return strings. Thanks Aarni Koskela. pl_PL
jobs added. Thanks Dariusz Choruży.- Added
ja_JP
provider. Thanks Tatsuji Tsuchiya, Masato Ohba. - Localized remaining providers for consistency. Thanks Flavio Curella.
- List of providers in compiled on runtime and is not hardcoded anymore. Thanks Flavio Curella.
- Fixed State names in
en_US
. Thanks Greg Meece. - Added
time_delta
method todate_time
provider. Thanks Tobin Brown. - Added filename and file extension methods to
file
provider. Thanks Tobin Brown. - Added Finnish ssn (HETU) provider. Thanks @kivipe.
- Fixed person names for
pl_PL
. Thanks Marek Bleschke. - Added
sv_SE
locale providers. Thanks Tome Cvitan. pt_BR
Provider: Addedcatch_phrase
to Company provider and fixed names in Person Provider. Thanks Marcelo Fonseca Tambalo.- Added
sk_SK
localized providers. Thanks @viktormaruna. - Removed
miscelleneous
provider. It is superceded by themisc
provider.
- Localized providers
- Updated
ko_KR
provider. Thanks Lee Yeonjae. - Added
pt_PT
provider. Thanks João Delgado. - Fixed mispellings for
en_US
company provider. Thanks Greg Meece. - Added currency provider. Thanks Wiktor Ślęczka
- Ensure choice_distribution always uses floats. Thanks Katy Lavallee.
- Added
uk_UA
provider. Thanks Cyril Tarasenko. - Fixed encoding issues with README, CHANGELOG and setup.py. Thanks Sven-Hendrik Haase.
- Added Turkish person names and phone number patterns. Thanks Murat Çorlu.
- Added
ne_NP
provider. Thanks Sudip Kafle. - Added provider for Austrian
de_AT
. Thanks Bernhard Essl.
- Fixed setup
- Added MAC address provider. Thanks Sébastien Béal.
- Added
lt_LT
andlv_LV
localized providers. Thanks Edgar Gavrik. - Added
nl_NL
localized providers. Thanks @LolkeAB, @mdxs. - Added
bg_BG
localized providers. Thanks Bret B. - Added
sl_SI
. Thanks to @janezkranjc - Added distribution feature. Thanks to @fcurella
- Relative date time. Thanks to @soobrosa
- Fixed
date_time_ad
on 32bit Linux. Thanks @mdxs. - Fixed
domain_word
to output slugified strings.
- Modified en_US
person.py
to ouput female and male names. Thanks Adrian Klaver. - Added SSN provider for
en_US
anden_CA
. Thanks Scott (@milliquet). - Added
hi_IN
localized provider. Thanks Pratik Kabra. - Refactoring of command line
- New provider: Credit card generator
- Improved Documentor
- FIX setup.py
- PEP8 style conversion (old camelCased methods are deprecated!)
- New language:
pt_BR
(thanks to @rvnovaes) - all localized provider now uses
from __future__ import unicode_literals
- documentor prints localized provider after all defaults
- FIX tests for python 2.6
- New providers:
Python
,File
- Providers imported with
__import__
- Module is runnable with
python -m faker [name] [*args]
- Rewrite fake generator system (allow autocompletation)
- New language: French
- Rewrite module
__main__
and new Documentor class
- First release