faker.providers.python

class faker.providers.python.Provider(generator: Any)

Bases: BaseProvider

enum(enum_cls: Type[TEnum]) TEnum

Returns a random enum of the provided input Enum type.

Parameters:

enum_cls – The Enum type to produce the value for.

Returns:

A randomly selected enum value.

pybool(truth_probability: int = 50) bool

Generates a random boolean, optionally biased towards True or False.

Truth_probability:

Probability of generating a True value. Must be between 0 and 100 inclusive’.

Returns:

Random boolean.

Raises:

ValueError – If invalid truth_probability is provided.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pybool()
...
True
False
False
True
True
pydecimal(left_digits: int | None = None, right_digits: int | None = None, positive: bool = False, min_value: float | None = None, max_value: float | None = None) Decimal
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pydecimal()
...
Decimal('-5569460909285877348467680444770915371158237492887019401748134836004002952390407391652215794296585.19489241157815659')
Decimal('1886186151383740879342731154329560131462583151547637532948768726136618.933287115871484185839894')
Decimal('-54602810789.3423209471122018684833969477515917953304135256012309891013991615109032173')
Decimal('37455882612449918873895377875743386337644899287997382144008992940928469288165599155251.456208709')
Decimal('29520400864827031997869787950014130505943352302226241530157614942414181281110432834362915.07150842375945992466109352337696069602714278789007547063812066503008913')
pydict(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) Dict[Any, Any]

Returns a dictionary.

Nb_elements:

number of elements for dictionary

Variable_nb_elements:

is use variable number of elements for dictionary

Value_types:

type of dictionary values

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pydict()
...
{'son': -9787526.29318886, 'voice': datetime.datetime(1977, 7, 20, 17, 43, 50, 909760), 'kitchen': 'NGnVZQUqLUJyfwFVYySn', 'amount': datetime.datetime(2019, 8, 29, 11, 25, 37, 971213), 'event': 'LuQIazTmqTjDmYPxeqAW', 'much': 'ppgrVkPCoePqmjQbZndJ', 'mention': 'TWRUWCuKoQSUEXExIZVP', 'interview': 'qfErjaoKtiwdOSlQGWFd', 'why': 'HFDutYbbXjgkPWbwfnlH', 'step': 7144}
{'ask': 'nVyUDKkNPiiBgVIaJUTV', 'most': 'paul42@example.net', 'manage': 'xeMChNzFJEUSgqMReEKi', 'among': 'HtTDvuKvIcxniBzDNTzq', 'pick': Decimal('11411791321240764654788082438993844835687523124385969.650300891319344217610471428512400034855909776582369'), 'blood': 38191497835621.5, 'scene': 6016, 'include': 'rGciZpuCpymcjBdurvfV'}
{'green': 987508377.174646, 'thought': 'odrake@example.org', 'success': 'QklufCpVOLlelZEijfQS', 'task': 'UxJgukcXlhktChZZhvJT', 'gun': Decimal('-993195182255103703960295170580683369394227422405918440248896642.305550824926947118013204075227586880918916348967699300248945174466602234500762'), 'capital': Decimal('67972839855751940235263820229154889584951907196767287332264888028711981316080836396161.7017200992518536710979519426418306753751007408993'), 'measure': 'eQUOKvpfwDVWvfOMbxJb', 'business': 4138, 'scene': 'sgJrjRltFhaIMUMpJWmh', 'modern': Decimal('4805760532403649269240146150593215888587311532081726339112030.5291189426223583324560290611264862964513758066065735471214189276266237'), 'last': 8574, 'always': 'sGeNpRxylfYpFwNezXCv'}
{'age': Decimal('21382039273173884082527988465816382796350650960388704316804460314001343271628396494204470750330.1448'), 'camera': 1936, 'expect': datetime.datetime(2016, 8, 4, 21, 51, 59, 155044), 'use': 'dSogBkfXCMVoxDhgguyD', 'relate': -797087381.435271, 'amount': 'yKqHdpMcGbyUaBdTJMIa', 'a': 'gaoHpUhDjwLtrHJhWhqk', 'establish': 'xPuPulkWEcumejcHjFFK', 'information': datetime.datetime(2010, 9, 28, 4, 31, 4, 504569), 'never': 6740, 'voice': Decimal('97183309942242775163299956300966980935197130931292396426904842486602508273832146.9774735400025040216396837359191558754080351385334448647'), 'party': 3931, 'see': 'pCazwVvzwemQhTlFQDUu', 'individual': 'mlRosZfUFPKOAyGoaFLi'}
{'energy': 'gHgMsJKIlRmAJmGoiQCr', 'discover': 'http://www.harrington.org/main/wp-contenthome.html', 'feel': 'mgmtFgzVGbEzqXCiTQMC', 'until': 'nFKQOtdbLYrwLInIpsCM', 'simply': 'szdmaXqQrIhVxhqHLOva', 'receive': -795959.45031711, 'according': 'http://lyons.com/wp-content/categoriesfaq.asp', 'site': 'XXUMRDLwSfGKFcrMtGUz', 'north': 4796, 'myself': 'stephenromero@example.org', 'later': 5531}
pyfloat(left_digits=None, right_digits=None, positive=None, min_value=None, max_value=None)
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyfloat()
...
-6.36438676418356
-424604.985946604
-61.8878635605209
-829528891695.97
-69804.3874773259
pyint(min_value: int = 0, max_value: int = 9999, step: int = 1) int
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyint()
...
6311
6890
663
4242
8376
pyiterable(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) Iterable[Any]
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyiterable()
...
('nAvOpyEVAoNGnVZQUqLU', 'thomas15@example.com', 3350, datetime.datetime(1995, 11, 11, 4, 51, 43, 736550), datetime.datetime(1984, 2, 14, 23, 18, 23, 546056), datetime.datetime(2019, 8, 29, 11, 25, 37, 971213), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd', 'HFDutYbbXjgkPWbwfnlH')
('dyFKunVyUDKkNPiiBgVI', 'yvDAqsRnDaMrcomXsosX', 'jenniferhughes@example.com', 'smithjames@example.com', 'mHtTDvuKvIcxniBzDNTz', -0.58427929423069, 'CYYRgaXvaaNYJFjFkpJj', Decimal('-23587860434913790978655934625693951978093570729960966912834032313989657524780944.4000348559097765823'), 9619, 38191497835621.5, 6016)
{'http://www.bruce-compton.org/tag/posts/searchfaq.php', 584, 'ohEsZgfLWqSLpRpfDzrP', datetime.datetime(1997, 3, 28, 12, 24, 34, 720222), Decimal('18000400001558710168379151556371850715591491746684745560870153172067760283158232944569591.3306016884'), 2036, Decimal('-5566738374584561609320871321036086986788440028749554064377698700636073309631096713016282417601397773.26351108731764303921376582197296687577389305550824926947118013204075227586')}
{'hUvefdviXPwvzSqnsgJr', 'FgqKHkOOfdKFWHYLpSXu', 'IajAndSXpvQdHgoRcbvz', 'http://www.garcia.com/category/tagscategory.jsp', 'aYQdUkkJWgatbFSjfrXg', datetime.datetime(1986, 7, 21, 10, 21, 1, 994750), 531.866983954573, 'butjsGXUcnbBDTlOUGAB'}
[7755, -9380404207.10591, 'BqthglAmjtISFuKgpvWE', -1385.61194945311, 'dana80@example.com', 138, 5253, Decimal('96801170218340119083001529540605235227463678180.14189276266237582571734'), 'RxylfYpFwNezXCvGboIa', 8619]
pylist(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) List[Any]
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pylist()
...
[663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, 7, 20, 17, 43, 50, 909760), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2019, 8, 29, 11, 25, 37, 971213), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']
['catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2019, 9, 28, 12, 10, 0, 820345), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']
['QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), datetime.datetime(2014, 11, 1, 1, 2, 45, 146597)]
['https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2003, 1, 21, 23, 32, 32, 898097), 'aKMqqBTFitpKyPAVdgpN', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', datetime.datetime(2016, 8, 24, 7, 4, 49, 444948)]
['OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2004, 6, 22, 16, 13, 48, 616128), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('-75235466116100008450701.3758257173407970341489')]
pyobject(object_type: Type[bool | str | float | int | tuple | set | list | Iterable | dict] | None = None) bool | str | float | int | tuple | set | list | Iterable | dict | None

Generates a random object passing the type desired.

Object_type:

the type of the object to generate.

Returns:

the random object generated.

Raises:

ValueError – if the object type passed is not supported

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyobject()
...
None
None
None
None
None
pyset(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) Set[Any]
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyset()
...
{'LuQIazTmqTjDmYPxeqAW', -424604.985946604, 'qfErjaoKtiwdOSlQGWFd', 'TWRUWCuKoQSUEXExIZVP', 663, 'ppgrVkPCoePqmjQbZndJ', datetime.datetime(1977, 7, 20, 17, 43, 50, 909760), 'NGnVZQUqLUJyfwFVYySn', -9787526.29318886, datetime.datetime(2019, 8, 29, 11, 25, 37, 971213)}
{'KunVyUDKkNPiiBgVIaJU', 'paul42@example.net', 'tYbbXjgkPWbwfnlHsjAc', 'HtTDvuKvIcxniBzDNTzq', 'catherinejohnston@example.com', datetime.datetime(2019, 9, 28, 12, 10, 0, 820345), 'xeMChNzFJEUSgqMReEKi'}
{-958272097856.158, 0.28952549189774, 'QTQjZGeLZuJqlLaQBfgH', 6016, datetime.datetime(2014, 11, 1, 1, 2, 45, 146597), Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), 'johnsonrobin@example.org', 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 4725240091.51995, 'rGciZpuCpymcjBdurvfV'}
{'james71@example.org', datetime.datetime(2003, 1, 21, 23, 32, 32, 898097), 'aKMqqBTFitpKyPAVdgpN', datetime.datetime(2016, 8, 24, 7, 4, 49, 444948), 'https://www.bolton-reid.com/category/blog/listregister.php', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518')}
{7424134494689.1, Decimal('-75235466116100008450701.3758257173407970341489'), 'OxNxPdcWzUXIDleQUOKv', 'kkJWgatbFSjfrXgYsypW', 'vfOMbxJbVYLedsbsaYQd', 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', datetime.datetime(2004, 6, 22, 16, 13, 48, 616128)}
pystr(min_chars: int | None = None, max_chars: int = 20, prefix: str = '', suffix: str = '') str

Generates a random string of upper and lowercase letters.

Parameters:
  • min_chars – minimum length of the random part.

  • max_chars – maximum length of the random part.

  • prefix – an optional prefix to prepend to the random string.

  • suffix – an optional suffix to append to the random string.

Returns:

Random of random length between min and max characters.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pystr()
...
'RNvnAvOpyEVAoNGnVZQU'
'qLUJyfwFVYySnPCaLuQI'
'azTmqTjDmYPxeqAWfCKC'
'QCYFExFuDpjjFIyeNTWR'
'UWCuKoQSUEXExIZVPeFz'
pystr_format(string_format: str = '?#-###{{random_int}}{{random_letter}}', letters: str = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ') str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pystr_format()
...
'F6-0486311W'
'n4-7596634Y'
'Z4-2198268i'
'U9-2414104I'
'w5-7811208R'
pystruct(count: int = 10, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) Tuple[List, Dict, Dict]
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pystruct()
...
([-424604.985946604, 1901, 4725240091.51995, 'TFitpKyPAVdgpNxSPTxt', 1376, 'TsMJmpeTNOTvcKIHCMwx', 'dprtyEhaAtHQTijZhkVz', Decimal('-5.4870898407616570040494388564319539852250909255445769620290725074931'), 'NiIWDsXDvFPlaBWJGGzM', 'taylorsara@example.org'], {'amount': 6890, 'benefit': 'catherinejohnston@example.com', 'TV': 'QTQjZGeLZuJqlLaQBfgH', 'network': 'fFzDHwBJURZHTCWaKMqq', 'others': 'xPdcWzUXIDleQUOKvpfw', 'property': Decimal('-808895120938038855082489339263990492580885868654677610560250832118988916.728457637785707427093057608116050190443294316756256627285232756676337390603'), 'sister': 'aFLivlTZaBwcuoYDlLCo', 'expect': 5531, 'through': 2321, 'high': 8395}, {'capital': {0: -9787526.29318886, 1: [datetime.datetime(1977, 7, 20, 17, 43, 50, 909760), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2019, 8, 29, 11, 25, 37, 971213)], 2: {0: 'LuQIazTmqTjDmYPxeqAW', 1: 'ppgrVkPCoePqmjQbZndJ', 2: ['TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd']}}, 'manage': {1: 'FkYLyLdJCGRddpwdyFKu', 2: [-900146288.946134, 'http://www.moreno-wilson.info/listsearch.html', 'alexandermaldonado@example.net'], 3: {1: datetime.datetime(2019, 9, 28, 12, 10, 0, 820345), 2: 'paul42@example.net', 3: ['xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq']}}, 'office': {2: 'johnsonrobin@example.org', 3: [-958272097856.158, 0.28952549189774, 'angela59@example.org'], 4: {2: 'https://taylor.com/tag/list/wp-contentcategory.htm', 3: 6016, 4: ['rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765')]}}, 'something': {3: 8680, 4: [datetime.datetime(1971, 10, 28, 15, 58, 20, 931850), 'JPNZMVkBFQzPuESPIajA', 529902351.901653], 5: {3: -6.8763381174432, 4: 'HgoRcbvzSLJhZvFucyhb', 5: ['http://reyes.com/explorelogin.php', 'FyGrgJGPgVPVTJQAOjOx']}}, 'final': {4: 'vfOMbxJbVYLedsbsaYQd', 5: ['kkJWgatbFSjfrXgYsypW', datetime.datetime(2004, 6, 22, 16, 13, 48, 616128), 'EeBqthglAmjtISFuKgpv'], 6: {4: 'EpsmGHBtaYUwtXejffFi', 5: Decimal('-75235466116100008450701.3758257173407970341489'), 6: ['wNezXCvGboIauUKxMsTI', 'EbPprBmVivpBDGBvGuOO']}}, 'explain': {5: -220.293506014432, 6: ['ciaIhOJYuVxrfTPqxqbc', 1312, 'TrRnLpAuzTmpCazwVvzw'], 7: {5: 'efNvVwewNRcjzgTWqwCo', 6: datetime.datetime(2012, 10, 10, 14, 57, 32, 167203), 7: [-65.812867516148, datetime.datetime(2004, 5, 22, 19, 9, 51, 581357)]}}, 'simply': {6: 'mgmtFgzVGbEzqXCiTQMC', 7: ['nFKQOtdbLYrwLInIpsCM', 'szdmaXqQrIhVxhqHLOva', -795959.45031711], 8: {6: 'http://lyons.com/wp-content/categoriesfaq.asp', 7: 'XXUMRDLwSfGKFcrMtGUz', 8: [4796, 'stephenromero@example.org']}}, 'customer': {7: datetime.datetime(2020, 9, 30, 3, 30, 28, 505942), 8: [8.8904196742809, 'bethanydavid@example.net', datetime.datetime(2002, 10, 20, 10, 9, 15, 603550)], 9: {7: 4354, 8: 7378402728.33841, 9: [datetime.datetime(1998, 8, 2, 7, 17, 58, 635611), 5607]}}, 'government': {8: 'DmjNvDmLSUQfjwdwuowN', 9: [9989, 1484, -28536838853283.6], 10: {8: 7137, 9: 'cterry@example.net', 10: [Decimal('-803358703760511880579625460078386755641445157885211429480481947118917938.820195501318705056246292648022270808625911824345448727820928'), 'UqXkPFQBKVhOceAaOfFD']}}, 'thing': {9: 'aUkvdqucNKsRecsUNIDP', 10: [2960, 'xnXdfbbuJUqPMKySBuOW', 'HeQrXybVGobtiChjVHmT'], 11: {9: 'https://www.allen.com/explore/tagscategory.html', 10: 'YsivsDuOiEJLihbqacWD', 11: ['OJtbwVrmhABdvIYwwylu', 'lsanders@example.org']}}})
([Decimal('75203566626017497199879123205931769.666'), 9100, 'ypxrmjXzftuAYYDGJAzq', 'CXOlmyhwszWhRJjWGgdr', 'http://hunt.info/wp-contentterms.htm', 'https://www.holland.biz/appcategory.html', datetime.datetime(1972, 1, 15, 9, 10, 17, 168075), 'tXVeSLVxvUBNjdwrArSM', 'sheltonbianca@example.net', 'JsSvEZCxeXBKImHfcRFp'], {'population': 'RqQuzssEOKNaBskVkjjI', 'while': datetime.datetime(2007, 9, 8, 17, 9, 22, 569796), 'trial': 'mWMzTstgOuAyItVwsuNZ', 'likely': 391, 'become': 575, 'standard': 3805, 'attorney': Decimal('838257207378766693632265118429895622258050188773106974236387977346073345768030436922069615353508.93023906227808532757343157458943486'), 'economy': 2661, 'letter': 7739}, {'glass': {0: 'LFirvEZoAWrGNGNkXjEp', 1: ['carterryan@example.net', 4408, 3410], 2: {0: 2198, 1: 'fsbDyHKewLhhibhzUGoP', 2: ['langrobin@example.com', -552452951273.991]}}, 'I': {1: -53027926098.7721, 2: [datetime.datetime(1986, 8, 7, 4, 49, 44, 812696), 6656, 'JiaEKWAKHkHZfJFtPaUQ'], 3: {1: Decimal('-8961477688316.94732881820286937640926279061965387079148786742'), 2: 'CiSRhdduXCnlfhQhSQhD', 3: ['bvKFLfysOTJmzZoasXWe', -29655.7468800909]}}, 'worry': {2: 'davislogan@example.org', 3: [796, 'http://wilson.com/categorymain.php', 'mctagFWkMkaURdjmWtPw'], 4: {2: 674, 3: 'https://www.holmes.com/category/category/categoryregister.html', 4: [19128319114515.6, 'DIkAgfVgUyxrvtDrQmmy']}}, 'foot': {3: 2627, 4: [Decimal('-74765413535133330981994143479116336837852388047167224028302697719585527000007663053054.528899629793970379583000'), 'mTFIfYAWGoJzjtRLuZqZ', 'hNNXuyCUKbkSETvkaZhH'], 5: {3: Decimal('-983984030807484866137748980786171911736615895271.703695410390985274197436685394102599718765601692201630446154593880588027045251986149181927083'), 4: 1586, 5: [datetime.datetime(2015, 5, 5, 5, 9, 40, 708121), 'ZKYuFMsnYsZSlRZoIOeQ']}}, 'whom': {4: 'vBveYZjmwKbRHoTIqCYc', 5: ['SKhFOvEnqQzxgtBmQtmq', 'VXaNBgmovyWdKSsmlphC', 190053.249788246], 6: {4: 2569, 5: 'NgRJMBOPSKbxVkvtuuBf', 6: ['BUUaMmuJZYIndNEMSNcQ', Decimal('311050267005934298358909854396255778414971377809816794768.8409255548420739657472745596696849336348282988875464780347103914032925940009')]}}, 'music': {5: 767112283.64448, 6: [2263, 4495, Decimal('-92771143523256038439987981589119938465989912960593165488807175902509585697289.976296219127416441588100902166705216930360096284668')], 7: {5: 'MxCDUHEieynlJSSBOTHi', 6: 'RAWfrMqhEdtnrzBeqtuy', 7: [8497, 'VhuTqThbHgdnpWTyEqIG']}}, 'reason': {6: 5996, 7: [8393, 'mefwGCAfcsXjozVXaHmI', 2633], 8: {6: 'NyIWRKJElbxGQIFqrwOS', 7: 'AutpkYBTUWmrGqhNCBKf', 8: [Decimal('-48542287744048307995004342.187346483565003392871484765601052498748675311180985919300141962998344229322347429431262390'), 8811]}}, 'student': {7: 9004, 8: ['OLDIpxNZkkZfuAyHbmet', 'UCBleWfgkDHwuHnPHFbr', 'KbklJQhxeoHuMWUpIFQt'], 9: {7: 'http://www.campbell-holmes.com/categoriesmain.html', 8: 'darrellmorris@example.net', 9: ['sQjZBwLtbwoIBRzihDnl', 'hVBWRpyetWfmcSJEynEK']}}, 'enjoy': {8: datetime.datetime(1978, 9, 1, 8, 2, 46, 939877), 9: [Decimal('4.922992114149794960'), 'hYdrHubpmOEhTlqTNvBY', 9330], 10: {8: 'tbradshaw@example.org', 9: Decimal('-502850235694362672917184272063.706704896799832041'), 10: [4212, 'zyAgzXiarKSfbqGVrOgH']}}, 'stand': {9: datetime.datetime(1976, 9, 29, 16, 20, 7, 232489), 10: ['aaron20@example.org', 5533, Decimal('6836695520569284612670011363684.48276010153481841189403127227427908601141634637988526096934')], 11: {9: 8406, 10: 7748, 11: ['tgilmore@example.com', 4469]}}})
([Decimal('-4.317218869431608750394678410156663476806472666994785469250677413536095227'), 'manuel19@example.net', 'OsAuBUfUAhWkbyDcGDDe', 3714, 2543, datetime.datetime(1973, 8, 30, 12, 5, 30, 746411), 'tina09@example.org', 'https://peterson.com/search/postsfaq.htm', 'jensenmichael@example.com', 7694], {'structure': 'jlyHtGWomZxAUkuKrgzU', 'check': 'ahMKHhgzzgYQTiIQqZeP', 'such': -8807246.97090297, 'style': 'uberg@example.net', 'politics': 'MZrMRKPQoovbVQgQrFzx', 'look': 2.80628089577333, 'large': 'PhQsgWxNqFzovPyjNTmG', 'interest': 'RZrECDIWaqyAVzmSAOnX', 'opportunity': 'EaOteDJsvsXnhRjhQOfE', 'media': 'otSGXlaSFgnXECOUuQTX'}, {'hour': {0: 'OjFlZaBVJJjuqBiiUIyM', 1: [-8728689982.35022, 7558, 'dHRlWGCkTwcWtpdbcTTy'], 2: {0: 'EbMhfKFIkfzeySZLifSL', 1: 8379, 2: ['eAbTmLZUBqKCVmKhvOso', 8280]}}, 'middle': {1: 'sufoWusHmbNBOinMnerv', 2: ['jeremy24@example.com', datetime.datetime(2004, 5, 14, 7, 49, 36, 165826), 'zTFdoKcaPiivEQVbCSjT'], 3: {1: 'vwatkins@example.com', 2: 1917, 3: ['vjTlJSPMUUuFIWFzNiJt', Decimal('35743822405970315047409155821334.042124264865867714954446980788364600681400768587878792909534613129727572')]}}, 'office': {2: 2139, 3: [Decimal('-53232.1914495207663'), 'vnzIUhQNGjdhqpQriYKP', Decimal('746550139327.75215245116554503422827318410616772201216914199134628745264221385715864702527')], 4: {2: 'WdVwfNggmCISEHzAIopG', 3: 'http://gonzales-rodriguez.info/bloglogin.html', 4: [datetime.datetime(2023, 4, 10, 22, 42, 59, 355571), datetime.datetime(2003, 3, 20, 6, 31, 41, 498982)]}}, 'total': {3: 8099, 4: ['BMbMPaDahTcVINJNMUst', 'paula36@example.net', 'FlaxahkEgVONTOxBzQAp'], 5: {3: datetime.datetime(1988, 1, 2, 12, 8, 9, 676489), 4: 'sarah40@example.org', 5: [Decimal('-368868519067982364376680656333311371788260779377484.3293148829271736210801192293551167259839399794126132244527581'), 'udrUPWErzzmTdrYDXaQG']}}, 'make': {4: 436, 5: [9.11012969050709, 8387, Decimal('99358682787537961629144941031692360726044599262838050.59211313730654594780476370896539542243156244926012661193813578912299907')], 6: {4: 10709932460.275, 5: 'wheelergeorge@example.net', 6: ['BDZetCPTGIUPEavdYQrf', 'http://reynolds.org/exploreindex.php']}}, 'visit': {5: 'IPgtjlCbcvoRbqvkAsmb', 6: [Decimal('8040189872506360766819615.93303145542296406197263'), 6343, 'DxGQVHBlulLChibfGHBP'], 7: {5: datetime.datetime(1992, 7, 23, 8, 30, 27, 407765), 6: 'NtclxFOSONEkIKntpZKs', 7: ['VmYkJgZIYsuTIBJnKAMU', 'AvCjPoSMpzpWSCJePsnr']}}, 'table': {6: 6756, 7: [datetime.datetime(1989, 12, 9, 7, 39, 44, 38927), 'iHXBhsAwhFTYjIbhAFmM', datetime.datetime(2022, 8, 4, 6, 6, 12, 89596)], 8: {6: 'MyFVzrGkGvArZVnOKdRP', 7: 'IwKZrxrqmsssXtaYEqPb', 8: ['qwegICYNsZelwHKodoWl', Decimal('28495212173475883838.0150337449585798032331210981996776098583294846980799364841594847719451650')]}}, 'admit': {7: 7477, 8: [-4.99867530923159, 'CxneWZCOsSstrYTcAqoG', 1230], 9: {7: 324, 8: Decimal('477406728948857499627079274850925836633217956.07235310676905007432716804120046894157954530837806508318308523'), 9: ['https://phillips.com/wp-content/searchindex.php', 'udTJfZFUicBiEehjutrD']}}, 'military': {8: 6626295.56182462, 9: [1595, 2452, 5.52656646540623], 10: {8: 4392, 9: 'lori63@example.org', 10: ['EZwPKNtbvVQecuGkaKlF', Decimal('-3548170133182117559702741292304172278579945018719500824429909070904380917795.518972963240757583490')]}}, 'easy': {9: 'http://www.krueger-green.org/tags/tags/tagpost.html', 10: ['PyWkjNxMRvBJwqiNpikE', 'dgWDodDRfnLDGSXWQbLF', 9623], 11: {9: 'gvIETTCUPhausbQAYRQu', 10: 'fCkHucUVHkvKgkeWNhmI', 11: ['lSwSaBvOXfNsTSZAzlcV', 'nHOfrGYfTpDfyVlmcDyC']}}})
(['http://hayes-david.info/explorepost.html', datetime.datetime(2020, 11, 12, 10, 30, 48, 785254), 4561, 'ZBdvTqMeNFxkzPcnppIW', 4773, 100747154.732271, 'rPzGqsGUZRSoTGRUHZsx', Decimal('9261180484357572076354885502404.39521633993627491143005174476438589156518297'), 'clZVPANXtkWjaKclsLBo', 'hcnLWQZQFOGqFPyBJFzR'], {'director': 4055, 'face': 'rQLmAoOqqRkepfvBqvyS', 'guy': datetime.datetime(2021, 12, 9, 15, 52, 37, 947284), 'college': datetime.datetime(1995, 8, 19, 9, 32, 39, 392289), 'at': 884, 'can': 3333, 'military': 7165, 'year': 'https://martin-schaefer.com/search/blogabout.htm', 'entire': 'VpIbxwyoILzrSISEykTA', 'usually': 'smithangel@example.com'}, {'more': {0: -24.7966326371136, 1: ['carriecollier@example.com', 7045, 17566963.908774], 2: {0: Decimal('919637158096508818537562445322.404736349505060980006947508616405005190819803996411212833794630887132671'), 1: 'lNgwIvFjbZIizDhTuyxM', 2: [5440, 'meganevans@example.net']}}, 'issue': {1: 1084, 2: ['https://smith-long.com/main/main/mainlogin.htm', 'http://www.adams.org/tag/listprivacy.php', 'http://www.martin.com/wp-contentfaq.asp'], 3: {1: 2289, 2: datetime.datetime(1985, 10, 28, 8, 26, 43, 900917), 3: [Decimal('948873339988040234071702334336483127159087212989532606456556917209071942721478197.0744806792020865150783460677231881838654390541992170754620822634989003095479448552178112256'), 'CLGnTaPWWvZfQvPMLRhM']}}, 'into': {2: 699967262938.58, 3: [Decimal('-1637968718224547627616191634321911731791951184023046624080108007704924138937.7862880348340854620394374006'), 9019, 'KJtlNNADLrIYTtrkLmEb'], 4: {2: Decimal('45827569810606675202517197.13666'), 3: 'thomaskeith@example.com', 4: ['bradleykenneth@example.com', 'FPsIsGcfISqMOdIwkkQJ']}}, 'example': {3: 'http://spencer.com/tagspost.jsp', 4: ['NZyxhJUdHkhIoeLTENJB', Decimal('-68479371166375438706734051141415597.60003610679314027901042723338007752109'), 'UHXuOOzPfhtqBIkBFPOD'], 5: {3: 165574.198978777, 4: 1103, 5: ['oTABfXgYjcWboIDMqNcb', 'PrGQHKoyYfmoOFLMUCtV']}}, 'heavy': {4: 4584, 5: ['hrkwBdjGReXAOdsyDYAV', 'sTqLKFUPQwULqvmSttuD', 811.73905987885], 6: {4: 3399, 5: 'krStdSOCchsvpNYwixhy', 6: [8855, 'logan02@example.net']}}, 'everything': {5: Decimal('68.131339355044059052616827785050177038016162799496080932927273'), 6: ['AcATuRNQrFHfiILczywN', 'bWMtmEBXYOTJOBKwVVZn', 'dWQhPXvBUnsSUNsYvnkx'], 7: {5: 'eaSvEZWGMHvgkplWkmKY', 6: 'kelly23@example.net', 7: [datetime.datetime(1996, 10, 14, 19, 30, 13, 495441), 'zGaRLkXZGRZpjqYpxSjx']}}, 'such': {6: 'zpayne@example.net', 7: [106, 376, 'https://robertson-herrera.org/listterms.html'], 8: {6: datetime.datetime(2017, 6, 19, 0, 40, 55, 854857), 7: 'wagnerdavid@example.org', 8: [-54803922.473458, 'williamsmith@example.net']}}, 'citizen': {7: 'https://davis.com/categories/blogprivacy.html', 8: ['jessica85@example.net', 'KPKLbkPbIEDfeZvplyGU', 'https://stevens-patel.com/main/listindex.php'], 9: {7: 'XjQZUHhEJWJibPsrsVRP', 8: Decimal('5822164716996172319252608559174830156192676512305368069784163320513061697.71841950924257365805597376995667327030702128311638026216583701138118'), 9: ['GaWnxBYqIRDlogMzrVkg', 'https://garcia-williams.com/app/wp-contentprivacy.html']}}, 'expect': {8: 'PwxTEOCJPRjKLwpkWJVH', 9: [3718182594.19431, datetime.datetime(2023, 3, 7, 16, 19, 17, 770035), 85.833701977546], 10: {8: 'QAlxzQzSwjvPFVKKWLCT', 9: 'WlzHcvFRcqqiqZzdOZVF', 10: [5035, 'http://www.torres.com/app/main/blogregister.htm']}}, 'person': {9: 3.49312048283484, 10: [2796, 3116, 863], 11: {9: 'nYFlpEauZmcjxERRLrIA', 10: 'AlnRDYPnKrQpTzKvYjZJ', 11: ['otXBHKVvOxrMFqEfVbdK', 'WvWAepzTdCCTtyIlHxmm']}}})
(['xXzqjAalBTtrqSAUJnue', 'ZpKPitsiINHMevzYxCBj', 'nicoledalton@example.org', 'UIRyeyLlgZxHZKvCzxDq', 'richardcampbell@example.org', -3223.4498078758, 'OXXtemWVJOLAoRkQGPSm', 7985, 'https://www.barrett-doyle.com/explore/appprivacy.htm', 665], {'economy': 'JouYrExvmtRxZXngKbkp', 'area': 'XIMWXYaEXHjirBvteHuA', 'teach': 'CyablnxUWoJCUpxEvvkM', 'life': 'rileyfrank@example.com', 'realize': 'KYYukvkNLyvsMLpTtWmk', 'never': 'oyHhsmVnjDwYUfHtqrsq', 'blue': 'WOFXuxIRpgblNdeqrKwf', 'relate': 'joRqISClAbtjudIJPEgh', 'plant': 'amUZkPtqbOFtxEvkDnHq', 'fact': 0.41512800576666}, {'soon': {0: 'aWXgUaLEGoIizbIEqCmL', 1: ['david33@example.org', 'oyxkkyOilwolHygwxLUc', 'http://harper.com/list/category/tagssearch.html'], 2: {0: 'oYKSfvrkVOiFQuQBMQfO', 1: Decimal('53767584141777933.38569515701224423255833908387526773786431876945112378207287203239055'), 2: [Decimal('-2647767173920883731580718896497100927607521435378364690463863040669261787626938777770177576429070699.10289530181466457034565011059204949385833297621465546530625123827490778286199376858300496233969'), datetime.datetime(2021, 11, 29, 15, 55, 57, 97331)]}}, 'compare': {1: 'LXezkrcAngrgTKMZWpFz', 2: [17206187561897.0, 'ngAWjppRUyYDvkRKtiOb', 6696], 3: {1: datetime.datetime(1988, 5, 23, 9, 19, 2, 390251), 2: 'pgrcIBfchSYpwjLAamaw', 3: [66916.6865598951, 1724]}}, 'country': {2: datetime.datetime(2006, 10, 26, 7, 38, 10, 705039), 3: ['LsLrfTUwpuFoEGaiqFBR', 'usJtIxDunXEHoHCECnIe', -58303859.45914], 4: {2: Decimal('9178716153467927125353031735697269084425013021662458578972778120518.84165659635001986165355552551454426963913472424003551704273351147746598211264189482763'), 3: 4483, 4: [-2.30572690795121, 'purLIWSmxENbPKtoNqGQ']}}, 'born': {3: 'fdmwdERbChPIRJiJizit', 4: [Decimal('7400155851494316135813129336184988636030102676341028905124419331496724882571161923563236748.804691458864417347030105624011474264546698497632742192244415'), 'aZDqZnHwgnKmqjbckeJT', Decimal('413347434367531009245031122052977973170.6308996972698812925929659664366968371097805557949810142431')], 5: {3: 'WjpnAXagmwKEFSdOlOWT', 4: datetime.datetime(1982, 2, 4, 3, 30, 8, 949057), 5: [datetime.datetime(1995, 2, 5, 2, 43, 3, 718428), 'xthpUIduwVEOQcOABtOe']}}, 'chair': {4: 'RqrITJpQhXKDkxwBNQzG', 5: ['LFudRkDkauCncOzchKZW', 7476, 993], 6: {4: 'kIMaXOkrryujudzakkqA', 5: 'zFubdQzekqcFAOyCPRqf', 6: [4250, 'oIbsysVjNVAEiowxlQKI']}}, 'front': {5: -2.66711932144061, 6: [3282837.2518198, datetime.datetime(1984, 10, 25, 8, 51, 21, 569062), 4983], 7: {5: 'https://www.mann.com/explore/category/categoriesabout.php', 6: datetime.datetime(1982, 11, 18, 2, 46, 41, 710862), 7: ['AqBknmSuStqIvQHKYRrx', 'UCCelgqaAasfmInaQCTn']}}, 'begin': {6: 'https://www.graves.org/list/tags/listindex.asp', 7: ['chelsea36@example.net', 'ENAidzyEnMaSHncFLPQV', 9364], 8: {6: 'mdeleon@example.net', 7: 'tUrFRrgsosYSERAWnUDf', 8: [Decimal('6031733610998688364000283259749056959862.638887272778598032156'), Decimal('-4839639836350135760175738566626890868208735694452005977291136408656580037839806.292719599389652989781664579567127772321529829873386720984481074604708779857684901')]}}, 'hope': {7: Decimal('-90672949793874046126290670325725772551001402792340802785753935310827038102860399357974331520.966558627146308734004'), 8: ['http://www.ingram.com/explore/categories/categoryhomepage.html', 'ddUCTPMXrGVmaCwuuJBw', 'howardtracy@example.com'], 9: {7: datetime.datetime(1991, 5, 30, 7, 9, 19, 258911), 8: 1657, 9: [datetime.datetime(2003, 11, 7, 16, 19, 48, 317177), 'vHVrbMijYxYzLOHsjbxw']}}, 'face': {8: datetime.datetime(1982, 5, 14, 20, 43, 29, 1398), 9: ['YNTymfhoOgZcDDAiySnt', -9.73497336349291, 'XypapRZDzursQrDhTpxn'], 10: {8: 'sAyEZWjJvkaGsIqrHetW', 9: 'https://www.clark.net/bloghome.php', 10: [2654, 318]}}, 'training': {9: 533, 10: ['http://www.horton-rodriguez.com/app/main/postsabout.php', 1372, 'harryhogan@example.net'], 11: {9: Decimal('5102061998714412761883075326857803913855650471876497297.8671906154800521358058393511015766'), 10: Decimal('-739916688886034706607111444282744391770416237.85265076925'), 11: [Decimal('-866625407727055421434296508883.8131926734991070020723620328'), 'kdiOkOXKPOMKayuONwLj']}}})
pytuple(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: List[Type] | Tuple[Type, ...] | None = None, allowed_types: List[Type] | Tuple[Type, ...] | None = None) Tuple[Any, ...]
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytuple()
...
(663, -424604.985946604, -9787526.29318886, datetime.datetime(1977, 7, 20, 17, 43, 50, 909760), 'NGnVZQUqLUJyfwFVYySn', datetime.datetime(2019, 8, 29, 11, 25, 37, 971213), 'LuQIazTmqTjDmYPxeqAW', 'ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd')
('catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2019, 9, 28, 12, 10, 0, 820345), 'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'HtTDvuKvIcxniBzDNTzq')
('QTQjZGeLZuJqlLaQBfgH', 4725240091.51995, 'johnsonrobin@example.org', -958272097856.158, 0.28952549189774, 'angela59@example.org', 'https://taylor.com/tag/list/wp-contentcategory.htm', 6016, 'rGciZpuCpymcjBdurvfV', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), datetime.datetime(2014, 11, 1, 1, 2, 45, 146597))
('https://www.bolton-reid.com/category/blog/listregister.php', datetime.datetime(2003, 1, 21, 23, 32, 32, 898097), 'aKMqqBTFitpKyPAVdgpN', Decimal('-74655832342888117024.8091891634896769930024894517446660223450076279125609767017200992518'), 'james71@example.org', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', datetime.datetime(2016, 8, 24, 7, 4, 49, 444948))
('OxNxPdcWzUXIDleQUOKv', 7424134494689.1, 'vfOMbxJbVYLedsbsaYQd', 'kkJWgatbFSjfrXgYsypW', datetime.datetime(2004, 6, 22, 16, 13, 48, 616128), 'EeBqthglAmjtISFuKgpv', 'EpsmGHBtaYUwtXejffFi', Decimal('-75235466116100008450701.3758257173407970341489'))