`faker.providers.python`¶

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

Bases: faker.providers.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=None, right_digits=None, positive=False, min_value=None, max_value=None)¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pydecimal()
...
Decimal('-6048764759382421948924115781565938778408016097535139332871158714841858398947196593423209471122018.684833969477515917953304135256012309891013991615109032173008691413145620870916345792302')
Decimal('8419720769845642807150842375945992466109352.376960696027142787890075470638')
Decimal('20665030089131934421761047142851240003485590977658236940224555159004229456824173042814654611.77551717604522961113306016884779361534926351108731764303921376582197296')
Decimal('-757738930555082492694711801320407522758688091891634896769930024894.174466602234500762791256097670172009925185')
Decimal('7109795194264183067537510074089933188684126961161.620766075415')

pydict(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None, allowed_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None) → Dict[Any, Any]¶

Returns a dictionary.

Variable_nb_elements:
Nb_elements:	number of elements for dictionary
	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(1979, 6, 24, 16, 0, 13), 'kitchen': 878829203004.256, 'amount': datetime.datetime(2017, 12, 27, 3, 37, 52), 'event': 'https://www.jones.net/home/', 'much': 7113, 'mention': 3350, 'interview': datetime.datetime(2002, 6, 18, 3, 24, 51), 'why': Decimal('-8016097.351393328711587148418583989471965934232094'), 'step': Decimal('22018684833.96947751591795330413525601230989101399161510903217300869141314562087091634579230225841')}
{'will': -6367.93792040552, 'letter': 813715717273.8, 'reduce': 748, 'continue': datetime.datetime(1989, 2, 11, 9, 20, 9), 'add': 'mXsosXGGLuvHakrmHtTD', 'market': 516, 'responsibility': 9297, 'it': 766, 'we': 'xniBzDNTzqyQTQjZGeLZ', 'outside': 6840, 'two': 55, 'movie': 'aNYJFjFkpJjyVGbVPgnH', 'whose': 'darin24@example.org'}
{'amount': 9297, 'describe': 'SXFzHxwTjtphorteOboh', 'responsibility': 'https://anderson.com/post.html', 'event': datetime.datetime(2019, 8, 2, 23, 4, 14), 'open': 'pRpfDzrPQggzbrJiiDPZ', 'forward': 'deMdauAxzEJvtZnOwsdS'}
{'weight': 'znHZPGfxsRfFzDHwBJUR', 'never': Decimal('930555082492694711801320407522758688091891634896769930024894517446660.23450076279125609767'), 'live': 'fObFgqKHkOOfdKFWHYLp', 'soldier': 'XupMXZgSZbutjsGXUcnb', 'research': datetime.datetime(2015, 5, 11, 5, 23, 23), 'defense': 'http://www.frank.net/categories/categories/explore/search.php'}
{'knowledge': Decimal('-607541511505520351923031045093227175420355744852911894262235833245602906112648629645137.58066065735471214189276266237582571734079703414892671738640140046896714543910144'), 'wind': datetime.datetime(1993, 2, 17, 0, 31, 43), 'become': 'BmVivpBDGBvGuOOptGiK', 'would': 6573, 'book': 'http://chen-newton.com/tag/categories/register/', 'just': 'wallacedouglas@example.com', 'at': 'UlsuZSYJeXWusgaoHpUh', 'bit': 'http://www.murray-rivera.com/homepage.php', 'staff': 'thernandez@example.org', 'clearly': datetime.datetime(1991, 7, 6, 0, 6, 42), 'similar': 'kjsZwzLPwkKVbGTsMJmp', 'allow': 'KAoTsxGAXXWWEzKlncia', 'strong': 'taylorkristin@example.net'}

pyfloat(left_digits=None, right_digits=None, positive=False, 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: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None, allowed_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None) → Iterable[Any]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyiterable()
...
('nAvOpyEVAoNGnVZQUqLU', 'thomas15@example.com', 3350, datetime.datetime(2002, 6, 18, 3, 24, 51), Decimal('-8016097.351393328711587148418583989471965934232094'), Decimal('22018684833.96947751591795330413525601230989101399161510903217300869141314562087091634579230225841'), 'http://www.maldonado-mccullough.net/tags/category/about/', 813715717273.8, 748, datetime.datetime(1989, 2, 11, 9, 20, 9), 'mXsosXGGLuvHakrmHtTD')
(9297, 766, 'xniBzDNTzqyQTQjZGeLZ', 6840, 55, 'aNYJFjFkpJjyVGbVPgnH')
{128, 'HZPGfxsRfFzDHwBJURZH', 'CWaKMqqBTFitpKyPAVdg', 4902, 'horteObohEsZgfLWqSLp', 4202, 1780, 'DzrPQggzbrJiiDPZeQkl', 'ToacJDXWVcMKILUHtBkE', 'uAxzEJvtZnOwsdSKUxJg'}
(Decimal('-27586880918916348967.9930024894517446660223450076279125609767017200992'), 'daniel85@example.org', 8033, 'TFyGrgJGPgVPVTJQAOjO', Decimal('-375100740899331886841269611611620766075415115055203519230310450932271754203557448529118942622358.3245602906112648629645137580660'), 5253)
(4805, Decimal('14189276266237582571734'), Decimal('-0.414892671738640140046896714'), 4643, 'caitlinjohnson@example.com', -123925.569282276, 'UNdSogBkfXCMVoxDhggu', Decimal('45763778570742709305760811605019044329431675625662728523275667633739060.12502394918456708869774735400'))

pylist(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None, allowed_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None) → List[Any]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pylist()
...
[663, -424604.985946604, -9787526.29318886, datetime.datetime(1979, 6, 24, 16, 0, 13), 878829203004.256, datetime.datetime(2017, 12, 27, 3, 37, 52), 'https://www.jones.net/home/', 7113, 3350, datetime.datetime(2002, 6, 18, 3, 24, 51)]
[datetime.datetime(1987, 9, 23, 13, 42, 57), 'PCaLuQIazTmqTjDmYPxe', 8322, Decimal('84185839894719659342320947112201868483.969477515917953304135256012'), 'cDVBJbHFDutYbbXjgkPW', 'CGRddpwdyFKunVyUDKkN', 'meganpeterson@example.com', 'FxjyvDAqsRnDaMrcomXs', -9671.19847373924, -87353308.1354309, 'EKilxKJTbTDOKidKxUVF']
['zqyQTQjZGeLZuJqlLaQB', 'jFkpJjyVGbVPgnHQHfiS', 'cJDXWVcMKILUHtBkEahr', 1535, 584, 'ohEsZgfLWqSLpRpfDzrP']
['yKwpMUVGtYHdeMdauAxz', 'https://www.robinson-duarte.org/privacy/', 'wsdSKUxJgukcXlhktChZ', Decimal('668757738930555082492694711801320407522758688091891634896769930024894517.466602234500762791256097670172009'), 'https://www.dunn.info/home/', 'FyGrgJGPgVPVTJQAOjOx', 'xPdcWzUXIDleQUOKvpfw', 'http://www.brown-perry.com/explore/posts/tag/category/', 'zSqnsgJrjRltFhaIMUMp', 'WmhxyKnbkrXpTCrEeBqt']
['PqmNpvcgbedvCMhvHext', datetime.datetime(1973, 12, 9, 1, 6, 53), 6694, 'vLqkpyXPoDJPxuNwmxWh', Decimal('3407970341489267173864014004689671454391014485183216448298381.8644759221166972845763778570742709305760811605019044'), 'hDjwLtrHJhWhqkjsZwzL', 'wkKVbGTsMJmpeTNOTvcK']

pyobject(object_type: Optional[Type[Union[bool, str, float, int, tuple, set, list, Iterable[T_co], dict]]] = None) → Union[bool, str, float, int, tuple, set, list, Iterable[T_co], 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: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None, allowed_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None) → Set[Any]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyset()
...
{datetime.datetime(2002, 6, 18, 3, 24, 51), -424604.985946604, datetime.datetime(1979, 6, 24, 16, 0, 13), 7113, 'https://www.jones.net/home/', 3350, 663, -9787526.29318886, datetime.datetime(2017, 12, 27, 3, 37, 52), 878829203004.256}
{'PCaLuQIazTmqTjDmYPxe', Decimal('84185839894719659342320947112201868483.969477515917953304135256012'), 8322, -87353308.1354309, 'EKilxKJTbTDOKidKxUVF', 'meganpeterson@example.com', 'cDVBJbHFDutYbbXjgkPW', 'CGRddpwdyFKunVyUDKkN', -9671.19847373924, 'FxjyvDAqsRnDaMrcomXs', datetime.datetime(1987, 9, 23, 13, 42, 57)}
{'ohEsZgfLWqSLpRpfDzrP', 584, 'cJDXWVcMKILUHtBkEahr', 'zqyQTQjZGeLZuJqlLaQB', 'jFkpJjyVGbVPgnHQHfiS', 1535}
{'https://www.robinson-duarte.org/privacy/', 'WmhxyKnbkrXpTCrEeBqt', Decimal('668757738930555082492694711801320407522758688091891634896769930024894517.466602234500762791256097670172009'), 'https://www.dunn.info/home/', 'wsdSKUxJgukcXlhktChZ', 'http://www.brown-perry.com/explore/posts/tag/category/', 'yKwpMUVGtYHdeMdauAxz', 'FyGrgJGPgVPVTJQAOjOx', 'zSqnsgJrjRltFhaIMUMp', 'xPdcWzUXIDleQUOKvpfw'}
{'PqmNpvcgbedvCMhvHext', 6694, 'wkKVbGTsMJmpeTNOTvcK', Decimal('3407970341489267173864014004689671454391014485183216448298381.8644759221166972845763778570742709305760811605019044'), datetime.datetime(1973, 12, 9, 1, 6, 53), 'vLqkpyXPoDJPxuNwmxWh', 'hDjwLtrHJhWhqkjsZwzL'}

pystr(min_chars: Optional[int] = 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: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None, allowed_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None) → Tuple[List[T], Dict[KT, VT], Dict[KT, VT]]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pystruct()
...
([-424604.985946604, datetime.datetime(1970, 12, 16, 0, 12, 4), 'mHtTDvuKvIcxniBzDNTz', 7424134494689.1, 'hDjwLtrHJhWhqkjsZwzL', 'GUfRBsxalHIzXzqSnFKQ', 'nJKWZNNAuRngZPXmJBTi', 'dLIyqRXbugZHvhhTAiUV', 3686, 'rArKVZMpTZsXAYZQJiaE'], {'amount': 6890, 'assume': datetime.datetime(1987, 9, 23, 13, 42, 57), 'good': 'https://perry.com/terms/', 'movement': 'butjsGXUcnbBDTlOUGAB', 'short': Decimal('3407970341489267173864014004689671454391014485183216448298381.8644759221166972845763778570742709305760811605019044'), 'perhaps': 'QCrEbguYAdNOODKlMQNs', 'explain': 'xAiNrPXaBoybBCWbugsc', 'herself': 'zNkuwHIKQEsDDoQuVheS', 'market': 4024, 'way': 4288}, {'level': {0: -9787526.29318886, 1: [datetime.datetime(1979, 6, 24, 16, 0, 13), 878829203004.256, datetime.datetime(2017, 12, 27, 3, 37, 52)], 2: {0: 'https://www.jones.net/home/', 1: 7113, 2: [3350, datetime.datetime(2002, 6, 18, 3, 24, 51)]}}, 'property': {1: 'LuQIazTmqTjDmYPxeqAW', 2: ['ppgrVkPCoePqmjQbZndJ', 'TWRUWCuKoQSUEXExIZVP', 'qfErjaoKtiwdOSlQGWFd'], 3: {1: 'HFDutYbbXjgkPWbwfnlH', 2: 7144, 3: ['dyFKunVyUDKkNPiiBgVI', 'yvDAqsRnDaMrcomXsosX']}}, 'stock': {2: -0.58427929423069, 3: ['CYYRgaXvaaNYJFjFkpJj', Decimal('-10471428512400034855909776582369402245551590042294568241730428146546118775517176.4522'), 'odrake@example.org'], 4: {2: 'QklufCpVOLlelZEijfQS', 3: 'UxJgukcXlhktChZZhvJT', 4: [Decimal('-738930555082492694711801320407522758688091891634896769930024894.174466602234500762791256097670172009925185'), 'tOzTFyGrgJGPgVPVTJQA']}}, 'hear': {3: 'vfOMbxJbVYLedsbsaYQd', 4: ['kkJWgatbFSjfrXgYsypW', datetime.datetime(2013, 4, 10, 18, 29, 48), 3015], 5: {3: 'http://bennett.com/', 4: 'qmNpvcgbedvCMhvHextX', 5: ['taYUwtXejffFiKWjvjXr', datetime.datetime(1979, 9, 14, 12, 49, 15)]}}, 'Congress': {4: 'wkKVbGTsMJmpeTNOTvcK', 5: ['fcarpenter@example.com', Decimal('4000250402163968373591915587540803513853344.864753048107770677711131263791686023732'), -466909854.112496], 6: {4: datetime.datetime(1989, 6, 6, 6, 50, 10), 5: 'http://palmer-murray.com/wp-content/main/privacy.html', 6: ['MmoMIMASgHgMsJKIlRmA', 'jesus74@example.net']}}, 'remain': {5: 28006329.642363, 6: [4089, 7228, 'jordanpowers@example.com'], 7: {5: 'sCMhbGbclIddYvUlwsjr', 6: 6269, 7: ['vnBMJycVvuahTAMhrRQm', 'XUMRDLwSfGKFcrMtGUzs']}}, 'food': {6: 'rMaQDXsGqOFZahcgWXyX', 7: ['julie31@example.net', 4566, 'BdHEWGCuwqaOQonBqrKw'], 8: {6: 'RNiIWDsXDvFPlaBWJGGz', 7: 'DmjNvDmLSUQfjwdwuowN', 8: [9989, 1484]}}, 'lawyer': {7: 'blairapril@example.net', 8: ['wherring@example.net', 'ejnPrKOAxVNxhGjAUqXk', Decimal('8252780818501169597568512502205930604609251607599449762074.615110502690578771086408')], 9: {7: 'ResfYiAPXarXKiOiJXWr', 8: 'zUJcmoimlTyThDaWauPZ', 9: ['bqacWDhhOOvDJKVslugD', 1581]}}, 'suffer': {8: 3933, 9: ['lsanders@example.org', -2329332817.79171, 'http://carr.com/list/app/blog/index/'], 10: {8: 6440, 9: 1717, 10: [Decimal('-25762948155257803429.46048606463522195206967116882223230827594'), 1941]}}, 'benefit': {9: datetime.datetime(1977, 4, 8, 20, 59, 34), 10: ['caitlinmorrison@example.net', 'nMiebgsLqJtKIQliCUOA', 'bHiZvIwJnEViwctPHvmT'], 11: {9: 'yfRzHyjCiSRhdduXCnlf', 10: 'seIcIEkbvKFLfysOTJmz', 11: [4333502024.46512, datetime.datetime(1993, 3, 13, 9, 52, 14)]}}})
([4545, 6.32132109655154, Decimal('853323422848023623829.238407306268636887121801036746564129330081737298409255548420739657472745596696849336348'), datetime.datetime(1975, 2, 1, 10, 39, 55), Decimal('-1118098591930014196299834422.322347429431262390587241949302390622780853275734315745894348612619182726483'), datetime.datetime(1991, 11, 17, 3, 8, 29), 95402814.5568158, 'yVKwRbtXfeNkLlHARjHa', 'GJsufoWusHmbNBOinMne', Decimal('-7626363412755475327253721899752152451165545034228273184106167722012169141991346287452.6422138571586470252733127615315233985759784409924388147210788899866595357280720180')], {'her': 'pvMYShokOIOoFRgsTlKG', 'likely': Decimal('76070867363477237457928134810250592763673260.5835288996297939703795830002379318645732585767571231267835006316996830287468811970369541039098527419'), 'lawyer': Decimal('-4364000415584038249066.93458771652803760314122705861837446'), 'that': 7023491653.66725, 'tonight': datetime.datetime(1998, 3, 26, 14, 2, 2), 'business': -746204220769.149, 'southern': 175, 'company': 'mTDnixaarkCApeCpdVfi', 'prove': 3105, 'yet': 4371}, {'east': {0: 6567, 1: [7.41007933702402, 'xrmjXzftuAYYDGJAzqJe', 6459], 2: {0: 'QwcOvnLjjKbXaBgQFVey', 1: 'BGvBWlvyakYcXbstrxgA', 2: [422078767603.88, 'GItDIkAgfVgUyxrvtDrQ']}}, 'personal': {1: 'http://www.stewart.org/register.html', 2: [datetime.datetime(2002, 8, 17, 13, 28, 37), 5233, 397], 3: {1: 'wIYNUgwbotrtPjQCrCiz', 2: 'HnhZfDXNnfdZgbRlfRlj', 3: ['raymondlynch@example.net', Decimal('-45833752480154501904.24388571688611')]}}, 'large': {2: 'AQAUOAQyrwxHcLYxdkfn', 3: ['QlUGVIFnJIbViTYmQMSe', 1889, 'NaBskVkjjIFAEWSVcUbH'], 4: {2: 'AvrVWGLrhYIoYFrUePif', 3: -637542.480812422, 4: [2605, 'http://www.ayala.info/blog/main/privacy/']}}, 'for': {3: 'caOhguYUqQeuEZcvVbFu', 4: [datetime.datetime(2019, 10, 3, 15, 39, 13), -73329244.91903, Decimal('23921974443600810422821505259115347577881157668786813268521220691184945.7695978538065580391715693808810950525477603752078264973079929759569286635643343895739')], 5: {3: 2399, 4: 3990, 5: ['RniKFUxkjsmPCVpokRqb', 'XFiCeAJvqJWTuSfdZNFD']}}, 'memory': {4: 'MnYtcRuLCOLDIpxNZkkZ', 5: ['BgJMikmFvUCBleWfgkDH', 9842, 4294], 6: {4: 'mbowman@example.org', 5: 5658, 6: ['KbklJQhxeoHuMWUpIFQt', 'http://www.dorsey-allen.com/']}}, 'local': {6: 'https://www.davis-banks.com/list/post.htm', 7: ['txuHcOoGwFDAiafunzyA', 'FnTKknKQIwqLkvWYgsLy', 'JsSvEZCxeXBKImHfcRFp'], 8: {6: datetime.datetime(1978, 6, 20, 13, 10, 1), 7: datetime.datetime(2015, 7, 6, 18, 33, 46), 8: ['aaron20@example.org', 5533]}}, 'enter': {7: 9870, 8: ['oAySMTLnoiTUqbyOKJbf', datetime.datetime(1982, 5, 27, 0, 59, 40), 'QXFCbvyXwaDdZILKWvoe'], 9: {7: 'CLrVkpNUPxAoZetvOKHm', 8: Decimal('-647266699478546925067741353609522711290320866246748027211744460945710.4374836160015044000902927192082111913176117782812568218083165858986439129654585000243221772442025'), 9: [3278, 'shawtroy@example.net']}}, 'benefit': {8: 6824, 9: ['OnIYQOjtXBfzTFdoKcaP', 'rUmCkYHNUxCxGrQsOasy', 'LMHULGVNaTjMvuiwZRMH'], 10: {8: 'nKiDpZjZnuBHqLzgFnLt', 9: datetime.datetime(1971, 8, 3, 11, 5, 12), 10: [Decimal('460068140076858787879290953461312972757274758305846891.282215300771980279294145275051191449520'), 'osullivan@example.org']}}, 'artist': {9: 'NfqqkdcljOXZXGZUkLFl', 10: ['UMvOdHWUqopUrvrnTxBu', 6612, 219.514166970582], 11: {9: -99232033.2177847, 10: 'yXiWkToRiSIgWwjRcbMe', 11: ['TEhksftgDBFNDFevZMjL', 'WnPqxKCNudrUPWErzzmT']}}})
(['DXaQGSMZrMRKPQoovbVQ', 'http://www.wilson.com/terms/', 'PoSMpzpWSCJePsnrUfZy', datetime.datetime(1988, 3, 8, 9, 37), 2452, 3686, -39824528299.6235, 'http://www.frank-woods.com/list/app/login.html', 'https://www.lopez.com/post/', 958], {'condition': 5432, 'create': 'HfTuQitIGAWQEJvAGRkx', 'country': datetime.datetime(1994, 1, 6, 22, 4, 17), 'especially': 'https://bates.org/terms/', 'bill': 5904, 'church': 12.8445587457978, 'grow': datetime.datetime(1986, 2, 25, 9, 43, 51), 'such': 'wxzRGSABGLMDuoMdXZUU', 'position': datetime.datetime(2016, 3, 5, 14, 43, 18), 'stage': datetime.datetime(2021, 10, 30, 4, 45, 44)}, {'continue': {0: 'PppiPaqiPpjEQeSAxQBO', 1: [5563, 'JDZiemkZLRXbSrsnVMXq', Decimal('-7089653954224315624492601266.1938135789')], 2: {0: 'OQiFFTwnBzacjzIBDZet', 1: datetime.datetime(1970, 1, 21, 10, 0, 37), 2: ['https://www.torres.com/post.php', 'phbaHVuwQDpaJxdOIPgt']}}, 'represent': {1: 23.4850800857031, 2: ['XPfDPVitlNgGTJscGlAz', 'http://www.turner.com/', 'GHBPCnNtclxFOSONEkIK'], 3: {1: -4929620.7802481, 2: 367.211676038078, 3: [3810, 'YkJgZIYsuTIBJnKAMUfY']}}, 'own': {2: 'william17@example.com', 3: [Decimal('-472406179211634169480906685332118924578362992520521859318178974591306485395417.0174547055355563'), 'uGBuFCTqwegICYNsZelw', 'andrew74@example.net'], 4: {2: 3503, 3: 'LxiaDJctcllnDtIqIKZG', 4: ['mMYffFeRPwHuMNBTqBgp', -9745.6034554523]}}, 'indicate': {3: Decimal('-9451650159183.0004718073484436977450999415126745493287747112804555065247088454951507925'), 4: ['https://griffin.com/main.html', 'jameslaura@example.net', 'https://www.smith.com/'], 5: {3: Decimal('68041200468941579545308378065083183085239787627420545436001295920082921228266054590390555.95516359423'), 4: datetime.datetime(1982, 8, 16, 15, 24, 37), 5: ['http://aguilar.com/homepage/', -7493593.24819938]}}, 'effect': {4: 5.52656646540623, 5: [4392, 'lori63@example.org', 'EZwPKNtbvVQecuGkaKlF'], 6: {4: Decimal('-6660422518972963240757583490724350496303962498326975792096654247469373277063.4614422342253992012494420495164598841880056975931661948520026505589'), 5: 'http://www.spencer.biz/app/home/', 6: ['HkvKgkeWNhmIYlSwSaBv', 'XfNsTSZAzlcVfwfbrfoZ']}}, 'nor': {5: 'mcDyCmTlQrLfxWyOjxil', 6: ['https://myers-anderson.org/tag/posts/tags/homepage/', 'adrian73@example.com', 'pqsbWNDGPMcXprbCfoMP'], 7: {5: 'dHJIGMaGGRNbEvofgimz', 6: 'https://www.boyd.com/author.htm', 7: ['uWxmTZiTznQCCKuKMQcp', 'https://barton-booth.com/category/author/']}}, 'huge': {6: 5242, 7: ['RpkmXilPTmBsSEyJZHQQ', -27987694980922.0, 'http://cook-simmons.biz/index/'], 8: {6: 1446358.4755738, 7: 'XZmULwAWVmdhkgUboLby', 8: ['http://www.dalton.com/index/', 'ole@example.com']}}, 'throw': {7: 'wLKOMpXEcbNItnQLoBZY', 8: ['HBQfhrlnssAMBUdIIWDK', Decimal('17262680564421978593803786288034834085462039437400668021563468592153066453839990733422730136660.944093476195175399'), 'PsxjpfaSFTzzDLAWiaxS'], 9: {7: 'stephanie21@example.net', 8: 'https://www.burns.com/post.asp', 9: [-9.92333215228619, Decimal('478579143675727514939284120898787420654600036106793140279010.27233380077521090036407418215583')]}}, 'season': {8: 6936, 9: [datetime.datetime(1987, 4, 21, 17, 33, 37), datetime.datetime(1980, 5, 31, 9, 17, 18), 'tuQVQvDDWMYWmaWbPrGQ'], 10: {8: 'mitchellsteven@example.org', 9: 3831, 10: [3836555553.71359, 'tVntdpZsTazldsIiHmCo']}}, 'you': {9: 'jason99@example.org', 10: [Decimal('35955990615665325668433163230561198905225765445627272685.1025531459017893077131339355044059052616'), datetime.datetime(2017, 3, 3, 20, 28, 53), 'IyBHabyKXBJVfgyDpuTB'], 11: {9: 'http://www.terrell-chavez.com/login/', 10: 'WyznIVxFCGNDHIxTnlPc', 11: [6262, Decimal('90839532488269146319562687146556564037531506639636510341341323965423870279104.43882542256457762973466705750575711844965715768068505097')]}}})
(['JdpPkBlfvCnrxLhEFYFv', Decimal('96498230713749440954109070210441113990559970897649035552636004983429064.0092792395468187344059494345844'), 'EGoIizbIEqCmLUsPRhoy', 'yangsara@example.org', 'gedWgdfLgtXFbfFFDPiD', 'aFAfMsttFRRqUdGKXvvG', Decimal('6080838950218132653163237964524465333626432055904372028357638227892090620396370688147057072295750139.0164315357868336177073033498217966200117911365409897885154040065079523289924772342132'), 'OXXtemWVJOLAoRkQGPSm', 6880, datetime.datetime(2014, 12, 12, 9, 1, 30)], {'large': datetime.datetime(2011, 9, 11, 10, 45, 29), 'trip': 'http://fleming.com/list/app/author/', 'notice': datetime.datetime(1970, 1, 20, 18, 9, 53), 'child': 'lindsay91@example.com', 'group': 8860, 'strong': datetime.datetime(1989, 5, 3, 19, 0, 24), 'lay': 'http://www.torres.com/category.htm', 'blue': 'WOFXuxIRpgblNdeqrKwf', 'day': 'http://www.charles-jackson.biz/explore/tags/wp-content/category.htm'}, {'draw': {0: Decimal('-834233733453952163399362749114300517447643858915651829799685482212140385685189.703860669883115684377299488751055728401727482291382701855653167998199974058718419509242573658'), 1: ['trTkvMDwyicjzafBJfgw', datetime.datetime(1971, 6, 18, 23, 25, 19), 'tgSAlxfkfYWeeXjWEVhZ'], 2: {0: 5.8972071583142, 1: Decimal('332967609290410602341309766734157659001997.37804303584065333509101359186432777391882159214643213344'), 2: ['TQCzQKeNQAlxzQzSwjvP', 'http://higgins-stephens.com/homepage/']}}, 'visit': {1: 7949, 2: ['KvYjZJkSHZxwGOkCSely', 'http://www.shelton.com/', datetime.datetime(1998, 10, 7, 12, 18, 22)], 3: {1: 'wayne17@example.com', 2: Decimal('-4887597.8307933930416565'), 3: ['ExvmtRxZXngKbkpmxXzq', 'pfksTjPmkHNctpoGaWXg']}}, 'drug': {2: Decimal('-532772836643547266763904.807906992009421045046166533297657829147912483856951570122442325583390838'), 3: [Decimal('-6773786431876945112378.07287203239055745955146'), 'JzGqswZgaBtUbDIwpqdZ', -423.948279537056], 4: {2: 920, 3: 'ecSRMTpOTFPRIPUlkGTQ', 4: ['eMWYtrrHwUQYGaNPwqXm', 'zExLCHSeSmYxvYCcUouh']}}, 'learn': {3: 'http://www.banks.com/', 4: ['lvVeEqPgqdcpbTfXoxwj', 'evzYxCBjaUWahTDeBPnw', 69], 5: {3: -435728.652881468, 4: 8106, 5: [17206187561897.0, 'ngAWjppRUyYDvkRKtiOb']}}, 'democratic': {4: -9.25499047212765, 5: [datetime.datetime(2010, 9, 24, 8, 10, 27), 5167, 'iCyablnxUWoJCUpxEvvk'], 6: {4: 9220, 5: 'TSbJbvkkwcLzToYYtigd', 6: ['qFBRYkdNAYIZFDRFfjiI', 'https://pena.com/search/tag/index.jsp']}}, 'lot': {5: 5473, 6: [6053, 'qerPRHHTvuFlXxUPWXcm', 1911], 7: {5: Decimal('27335114774659821126418948276354452.314665711832739540205749452094207'), 6: Decimal('7107634297715684777594111136719708226852523762152712501.44293678046914588644173470301056240114'), 7: [Decimal('-2645466984976327421922444151031958049761243395200031071438562388927630899697269881292592965966.3669683710978055579498101424311930464'), 'AXagmwKEFSdOlOWTBSAT']}}, 'front': {6: 'oyHhsmVnjDwYUfHtqrsq', 7: [datetime.datetime(1990, 9, 8, 8, 44, 25), 'mcharles@example.org', 'oUYiMyXVmWbhNoVvYFnL'], 8: {6: 1787, 7: 'https://arias.net/main.htm', 8: ['AqBknmSuStqIvQHKYRrx', 'UCCelgqaAasfmInaQCTn']}}, 'check': {7: 'http://jackson.info/privacy.asp', 8: [9985, 'uhtPAzksMvjXWSzZdIbr', datetime.datetime(2002, 11, 13, 8, 0, 28)], 9: {7: 9364, 8: 'mdeleon@example.net', 9: ['tUrFRrgsosYSERAWnUDf', Decimal('3472638887272778598032156769860952242927.195993896529897816645795671277723215298298733867209844810746047087798576849011333458286338105024670')]}}, 'employee': {8: 'uharrison@example.net', 9: ['mrqZDMrqMQhTHpkXBwpI', 'QpQSZYAsseOTRbhPXTrd', 'http://carpenter.biz/login.php'], 10: {8: 6512, 9: 'hford@example.net', 10: ['wJszrBVfGjWQvXcFsPZp', 'https://garcia.info/search/wp-content/homepage/']}}, 'summer': {9: -403564777.630018, 10: ['https://www.walls-johnson.com/tags/blog/homepage.asp', 'CmzLMXNgMOqOQYJKttTc', Decimal('-46968167430649799765592549728341724125879089263409505513186069432815833862604410.445060903902138665113512283789916983854867190615480052135')], 11: {9: datetime.datetime(1972, 5, 13, 20, 0, 7), 10: 8980, 11: ['DqTNcTVzGvrGOxChrxUF', 7644]}}})
(['jeremy63@example.org', 'ErakDNLFDzlzEVwpwnze', 'mJkUqRWXtnGbZowoWRBE', 383.60048828214, 'marcrobinson@example.org', 'aGsMMmeMyeEbSZfvVWts', 'FfmpqLvdKlZbQAnhkodT', 1482, Decimal('88658710731387241988050429185687999411753018689395675467168433225.757440755935023156231695495260921070383755685593144203547221898126660794612385692'), 'khall@example.org'], {'choice': Decimal('990938131926734991070020723620328031280368790.7864072731370561626986426848161508746977578830533446644203297388770987009139183269423499744'), 'her': 'KOJVbmkkcHEjCoPKzJTF', 'happy': 'kEQfOSDGZMpPEsVrEYVX', 'effect': 'DjiWeUtPPzAcowCEowkK', 'whom': 'oGgoKbMZCKtchWxfPdlt', 'line': 'HUaupRvsFEgOWNrrejTj', 'card': Decimal('539836361241.282976663811654766567630145805457199'), 'response': datetime.datetime(2013, 12, 19, 15, 45, 56), 'effort': 'jaclynsmith@example.net', 'third': 'http://campbell-jenkins.net/home.asp'}, {'first': {0: 'romeroderek@example.com', 1: ['http://jefferson.com/login.html', Decimal('-305667856448459400516597758220693123447943408239559371743660606173502.87680223710180085150378193440372350075860080281378883037'), 'gWciUUeILqBHxDmntujX'], 2: {0: -0.31636117266199, 1: 'yeuUzLxzoJkVRnAXSfvt', 2: ['OHnnxvKvUfhNTBCEQRqu', datetime.datetime(2018, 7, 19, 3, 56, 29)]}}, 'free': {1: 'anBHZZLtTIJqQsrEdbwv', 2: [3872568527.33448, 'SfBMDlzvgsZchSSfSSzj', Decimal('34593268944168514539651070314194604196385327186182817325290466038172.3770614396311163401583906021217539241654598133662913346460066406101904006898271190633301133758')], 3: {1: 5709, 2: 'grahamnicholas@example.com', 3: [5359, 'aPuYgSznWDOvqTvjIMVJ']}}, 'player': {2: 'http://www.brown.com/', 3: ['ONRRsnyLmTNpstrXEhlU', 164603683456.574, 'SfrFPIpcaRpIwvHFBfRx'], 4: {2: -13418.8102658908, 3: 1843, 4: [1719, -2793160.52434088]}}, 'owner': {3: 'EleIEItgenPsmpkhHlUh', 4: [2546.11306844312, 'phicks@example.com', 'xBJfoEWzjjbgEfirpUfC'], 5: {3: 6771, 4: 'nicolethomas@example.com', 5: [31.5033278098574, Decimal('481903296027678758771416311516663570582449020284569463357520424389.616776610340392262369802009244496311043880581853981777899799739188090069673050693791')]}}, 'people': {4: 6572, 5: [461, 'dIzMfCfysHiBVkzwUdyZ', Decimal('6913674481176632.10435123860401969168880911316999065960784570')], 6: {4: 4.34936479142583, 5: 'IYlZZTHmTQUAiPjCCkXX', 6: [Decimal('14290644884897648561917125516.46248490848273603494197294150226550125560519959527198727678473650762945313296075457100546'), 'paullane@example.org']}}, 'serve': {5: 'http://www.nelson.com/tags/tag/tags/privacy.asp', 6: ['UdHxQeRiCUXLQjRydTQb', 1281, 'OTEeDSwLbctgvFfkTjav'], 7: {5: 'FaWKLWfAlmbIOVOFXsqq', 6: 'https://www.anderson.info/', 7: ['AWHsUcioXTmEoWGLWPWh', 68059700486.5045]}}, 'energy': {6: 'ybNNTPwtrOhHaNkQwNHZ', 7: [datetime.datetime(2023, 3, 14, 3, 21, 14), 'FVJKtfvdqqigbGHYeVlw', 'yhorn@example.com'], 8: {6: 'kennedysamantha@example.org', 7: 'vschneider@example.net', 8: ['XRYyvNlvifOaKQWRQXum', 'ukzVGaKuSSnqLQDkMIYb']}}, 'now': {7: 'http://price.net/', 8: [6736, 'rXlSNOPbjhnwjyonMvdH', datetime.datetime(2004, 9, 13, 6, 49, 20)], 9: {7: 6084, 8: 'http://www.carter.org/', 9: ['jamielopez@example.org', 'nnCmDGPINzbrGyVjbwlR']}}, 'rule': {8: datetime.datetime(2021, 3, 8, 13, 13, 27), 9: [-562196649.797797, 4267, 9256], 10: {8: 'voxvLmXMNuUDUyYnklsO', 9: 'MpFBCXsagPIenwzHvatx', 10: [-53529716263.8117, 'nQgyFNSDYdrPlvwBhNYH']}}, 'as': {9: 'jmYbfvFOOdLUiIIGjwoP', 10: [7976, 'hdgwVxXXECPiQawUHlby', 'michael99@example.net'], 11: {9: Decimal('-4308951275298671272164708586084949092424779740712210360363183488983962119693490179.596003818025530342125100914469752519833822942249033264483022360'), 10: 'http://rubio.com/category/wp-content/home/', 11: [datetime.datetime(2001, 9, 2, 14, 13, 48), 'hwMDRRrEjsvkPIFuhlkP']}}})

pytuple(nb_elements: int = 10, variable_nb_elements: bool = True, value_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None, allowed_types: Union[List[Type[CT_co]], Tuple[Type[CT_co], ...], None] = None) → Tuple[Any, ...]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytuple()
...
(663, -424604.985946604, -9787526.29318886, datetime.datetime(1979, 6, 24, 16, 0, 13), 878829203004.256, datetime.datetime(2017, 12, 27, 3, 37, 52), 'https://www.jones.net/home/', 7113, 3350, datetime.datetime(2002, 6, 18, 3, 24, 51))
(datetime.datetime(1987, 9, 23, 13, 42, 57), 'PCaLuQIazTmqTjDmYPxe', 8322, Decimal('84185839894719659342320947112201868483.969477515917953304135256012'), 'cDVBJbHFDutYbbXjgkPW', 'CGRddpwdyFKunVyUDKkN', 'meganpeterson@example.com', 'FxjyvDAqsRnDaMrcomXs', -9671.19847373924, -87353308.1354309, 'EKilxKJTbTDOKidKxUVF')
('zqyQTQjZGeLZuJqlLaQB', 'jFkpJjyVGbVPgnHQHfiS', 'cJDXWVcMKILUHtBkEahr', 1535, 584, 'ohEsZgfLWqSLpRpfDzrP')
('yKwpMUVGtYHdeMdauAxz', 'https://www.robinson-duarte.org/privacy/', 'wsdSKUxJgukcXlhktChZ', Decimal('668757738930555082492694711801320407522758688091891634896769930024894517.466602234500762791256097670172009'), 'https://www.dunn.info/home/', 'FyGrgJGPgVPVTJQAOjOx', 'xPdcWzUXIDleQUOKvpfw', 'http://www.brown-perry.com/explore/posts/tag/category/', 'zSqnsgJrjRltFhaIMUMp', 'WmhxyKnbkrXpTCrEeBqt')
('PqmNpvcgbedvCMhvHext', datetime.datetime(1973, 12, 9, 1, 6, 53), 6694, 'vLqkpyXPoDJPxuNwmxWh', Decimal('3407970341489267173864014004689671454391014485183216448298381.8644759221166972845763778570742709305760811605019044'), 'hDjwLtrHJhWhqkjsZwzL', 'wkKVbGTsMJmpeTNOTvcK')

faker.providers.python¶

`faker.providers.python`¶