Locale ru_RU¶

`faker.providers.address`¶

class faker.providers.address.ru_RU.Provider(generator: Any)¶

Bases: Provider

address() → str¶

示例:: ‘791 Crist Parks, Sashabury, IL 86039-9874’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'г. Кропоткин (Краснод.), пр. Черемушки, д. 8 стр. 4, 421948'
'г. Бугульма, наб. Дорожников, д. 656 стр. 88, 840801'
'д. Сыктывкар, алл. 40 лет Победы, д. 439 к. 92, 115871'
'клх Гремячинск (Бурят.), наб. Одесская, д. 8 стр. 696, 423209'
'г. Верхний Уфалей, ш. Мельничное, д. 20 стр. 9/5, 396947'

administrative_unit() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Ямало-Ненецкий АО'
'респ. Карачаево-Черкесия'
'Ямало-Ненецкий АО'
'Ставропольский край'
'Краснодарский край'

building_number() → str¶

示例:: ‘791’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'7/1'
'9'
'7/5'
'6/4'
'34'

city() → str¶

示例:: ‘Sashabury’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'ст. Радужный'
'к. Тихорецк'
'с. Медногорск'
'к. Черкесск'
'д. Дзержинск'

city_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name()
...
'Орехово-Зуево'
'Радужный'
'Бавлы'
'Кропоткин (Краснод.)'
'Тихорецк'

city_prefix() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_prefix()
...
'ст.'
'с.'
'ст.'
'с.'
'г.'

city_suffix() → str¶

示例:: ‘town’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
'бург'
'поль'
'бург'
'поль'
'ск'

country() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Малави'
'Молдавия'
'Афганистан'
'Казахстан'
'Россия'

country_code(representation: str = 'alpha-2') → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code()
...
'MV'
'PS'
'NL'
'BB'
'IL'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code(representation='alpha-2')
...
'MV'
'PS'
'NL'
'BB'
'IL'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_code(representation='alpha-3')
...
'MDV'
'PSE'
'NLD'
'BRB'
'ISR'

current_country() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country()
...
'Russia'
'Russia'
'Russia'
'Russia'
'Russia'

current_country_code() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country_code()
...
'RU'
'RU'
'RU'
'RU'
'RU'

postcode() → str¶

示例:: 86039-9874
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'604876'
'759382'
'219489'
'411578'
'565938'

region() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.region()
...
'Ямало-Ненецкий АО'
'респ. Карачаево-Черкесия'
'Ямало-Ненецкий АО'
'Ставропольский край'
'Краснодарский край'

street_address() → str¶

示例:: ‘791 Crist Parks’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'ш. Фадеева, д. 848 к. 5/8'
'пер. Красноярский, д. 34 к. 994'
'ш. Братское, д. 2 стр. 957'
'наб. Блюхера, д. 4'
'пр. Азина, д. 1 стр. 116'

street_name() → str¶

示例:: ‘Crist Parks’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'ш. Добролюбова'
'ш. Фадеева'
'ул. Большевистская'
'пер. Вахитова'
'пр. Лермонтова'

street_suffix() → str¶

示例:: ‘Avenue’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_suffix()
...
'ш.'
'пр.'
'ш.'
'пр.'
'ул.'

street_title() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_title()
...
'Добролюбова'
'Фадеева'
'Дорожная'
'Большевистская'
'Вахитова'

`faker.providers.automotive`¶

class faker.providers.automotive.ru_RU.Provider(generator: Any)¶

Bases: Provider

Implement automotive provider for ru_RU locale.

来源

https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Russia
https://ru.wikipedia.org/wiki/Категории_транспортных_средств

license_plate() → str¶

生成一个车牌。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'О4876 53'
'Н8242 95'
'8924BХ 116'
'007D815 80'
'ТУ8778 47'

plate_letter() → str¶

Generate a letter for license plates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.plate_letter()
...
'О'
'О'
'A'
'M'
'С'

plate_number() → str¶

Generate a number for license plates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.plate_number()
...
'604'
'647'
'938'
'421'
'892'

plate_number_extra() → str¶

Generate extra numerical code for license plates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.plate_number_extra()
...
'6048'
'6475'
'8242'
'9489'
'4115'

plate_number_special() → str¶

Generate a special code for license plates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.plate_number_special()
...
'006D048'
'006D475'
'003T824'
'001CD9'
'008D924'

plate_suffix() → str¶

Generate a suffix code for license plates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.plate_suffix()
...
'96'
'173'
'10'
'47'
'83'

vehicle_category() → str¶

Generate a vehicle category code for license plates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vehicle_category()
...
'Tm'
'C'
'DE'
'Tb'
'C'

vin() → str¶

生成车辆识别码。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.vin()
...
'RT3GZYSK4Z9J97593'
'7G0K75MX5LDXV8156'
'G416S1YM2EF0V3513'
'66LZY7KJ7DJV61858'
'RLFJBCB3669039471'

`faker.providers.bank`¶

class faker.providers.bank.ru_RU.Provider(generator: Any)¶

Bases: Provider

Implement bank provider for ru_RU locale.

Sources for region codes, currency codes, and bank names

https://ru.wikipedia.org/wiki/Коды_субъектов_Российской_Федерации
https://ru.wikipedia.org/wiki/Общероссийский_классификатор_валют
http://cbr.ru/credit/coreports/ko17012020.zip

aba() → str¶

Generate an ABA routing transit number.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.aba()
...
'076048766'
'057593829'
'052194896'
'034115783'
'025659384'

bank() → str¶

Generate a bank name.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bank()
...
'МСКБ'
'Энергобанк'
'НИБ'
'Алтайкапиталбанк'
'ИС Банк'

bank_country() → str¶

Generate the bank provider’s ISO 3166-1 alpha-2 country code.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bank_country()
...
'RU'
'RU'
'RU'
'RU'
'RU'

bban() → str¶

Generate a Basic Bank Account Number (BBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'MYNB4876475938242'
'YDTZ4892411578156'
'KTUG8778408016097'
'KHXK1393328711587'
'DJRJ1858398947196'

bic() → str¶

Generate a bank identification code (BIC).

BIC is a bank identification code that is used in Russia. See https://ru.wikipedia.org/wiki/Банковский_идентификационный_код.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bic()
...
'046560098'
'048064359'
'043682092'
'041894492'
'045211957'

checking_account() → str¶

Generate a checking account number.

Checking account is used in banks to handle financial operations of clients. See https://ru.wikipedia.org/wiki/Расчётный_счёт.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.checking_account()
...
'41304064487647593824'
'30801971489241157815'
'41903969387784080160'
'51604554351393328711'
'40204188484185839894'

correspondent_account() → str¶

Generate a correspondent account number.

Correspondent account is established to handle various financial operations between financial institutions. See https://ru.wikipedia.org/wiki/Корреспондентский_счёт.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.correspondent_account()
...
'30104876475938242966'
'30148924115781565819'
'30177840801609753538'
'30139332871158714751'
'30185839894719659441'

iban() → str¶

Generate an International Bank Account Number (IBAN).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'RU75MYNB4876475938242'
'RU43YDTZ4892411578156'
'RU42KTUG8778408016097'
'RU34KHXK1393328711587'
'RU93DJRJ1858398947196'

swift(length: int | None = None, primary: bool = False, use_dataset: bool = False) → str¶

Generate a SWIFT code.

SWIFT codes, reading from left to right, are composed of a 4 alphabet character bank code, a 2 alphabet character country code, a 2 alphanumeric location code, and an optional 3 alphanumeric branch code. This means SWIFT codes can only have 8 or 11 characters, so the value of length can only be None or the integers 8 or 11. If the value is None, then a value of 8 or 11 will randomly be assigned.

Because all 8-digit SWIFT codes already refer to the primary branch or office, the primary argument only has an effect if the value of length is 11. If primary is True and length is 11, the 11-digit SWIFT codes generated will always end in 'XXX' to denote that they belong to primary branches/offices.

For extra authenticity, localized providers may opt to include SWIFT bank codes, location codes, and branch codes used in their respective locales. If use_dataset is True, this method will generate SWIFT codes based on those locale-specific codes if included. If those codes were not included, then it will behave as if use_dataset were False, and in that mode, all those codes will just be randomly generated as per the specification.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift()
...
'YNBIRU65ZT4'
'SGQERUSIGQ8'
'JDXCRUV4'
'LNKTRUN9'
'OQIBRU9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBRUQ6'
'PMZJRU4W'
'SGQERUSI'
'YDTZRUQ8'
'WZTERUTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBRUQ6'
'PMZJRU4W'
'SGQERUSI'
'YDTZRUQ8'
'WZTERUTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBRUQ65ZT'
'PLSGRU6ISIG'
'TZIRRUJTGEV'
'PRDLRU1UN94'
'OQIBRU9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBRUQ6XXX'
'PMZJRU4WXXX'
'SGQERUSIXXX'
'YDTZRUQ8XXX'
'WZTERUTGXXX'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBRUQ65ZT'
'PLSGRU6ISIG'
'TZIRRUJTGEV'
'PRDLRU1UN94'
'OQIBRU9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBRUQ6XXX'
'PMZJRU4WXXX'
'SGQERUSIXXX'
'YDTZRUQ8XXX'
'WZTERUTGXXX'

swift11(primary: bool = False, use_dataset: bool = False) → str¶

Generate an 11-digit SWIFT code.

This method uses swift() under the hood with the length argument set to 11. If primary is set to True, the SWIFT code will always end with 'XXX'. All 11-digit SWIFT codes use this convention to refer to the primary branch/office.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11()
...
'MYNBRUQ65ZT'
'PLSGRU6ISIG'
'TZIRRUJTGEV'
'PRDLRU1UN94'
'OQIBRU9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBRUQ65ZT'
'PLSGRU6ISIG'
'TZIRRUJTGEV'
'PRDLRU1UN94'
'OQIBRU9AFZA'

swift8(use_dataset: bool = False) → str¶

Generate an 8-digit SWIFT code.

This method uses swift() under the hood with the length argument set to 8 and with the primary argument omitted. All 8-digit SWIFT codes already refer to the primary branch/office.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8()
...
'MYNBRUQ6'
'PMZJRU4W'
'SGQERUSI'
'YDTZRUQ8'
'WZTERUTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBRUQ6'
'PMZJRU4W'
'SGQERUSI'
'YDTZRUQ8'
'WZTERUTG'

`faker.providers.color`¶

class faker.providers.color.ru_RU.Provider(generator: Any)¶

Bases: Provider

Implement color provider for ru_RU locale.

以人性化的方式生成颜色。

在底层，此方法首先创建一个以 HSV 颜色模型表示的颜色，然后将其转换为所需的 color_format。参数 hue 根据以下规则控制 H 值：

如果值是介于 0 到 360 之间的数字，它将用作生成颜色的 H 值。
如果值是介于 0 到 360 之间的两个数字的元组/列表，则颜色的 H 值将从该范围中随机选择。
如果值是有效的字符串，则颜色的 H 值将从与所提供字符串对应的 H 范围中随机选择。有效值包括 'monochrome'、'red'、'orange'、'yellow'、'green'、'blue'、'purple' 和 'pink'。

参数 luminosity 影响 S 和 V 值，并且部分受 hue 的影响。这种关系的具体细节有些复杂，如果您想深入了解，请参考源代码。为了保持接口简单，此参数可以省略，也可以接受以下字符串值：'bright'、'dark'、'light' 或 'random'。

参数 color_format 控制颜色以哪种颜色模型表示。有效值包括 'hsv'、'hsl'、'rgb' 或 'hex'（默认值）。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue='red')
...
'#af2f33'
'#e02141'
'#ef6466'
'#a80a14'
'#ed9e95'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(luminosity='light')
...
'#79c3e0'
'#89ffa1'
'#96cbf7'
'#aafaff'
'#e3f495'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(100, 200), color_format='rgb')
...
'rgb(26, 155, 88)'
'rgb(9, 193, 49)'
'rgb(73, 229, 154)'
'rgb(107, 249, 166)'
'rgb(76, 204, 69)'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue='orange', luminosity='bright')
...
'#efc332'
'#edae65'
'#d1861d'
'#ffcc42'
'#e09533'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=135, luminosity='dark', color_format='hsv')
...
'hsv(135, 96, 45)'
'hsv(135, 98, 57)'
'hsv(135, 94, 61)'
'hsv(135, 99, 47)'
'hsv(135, 94, 50)'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color(hue=(300, 20), luminosity='random', color_format='hsl')
...
'hsl(217, 94, 27)'
'hsl(40, 23, 54)'
'hsl(268, 100, 74)'
'hsl(175, 43, 31)'
'hsl(131, 47, 11)'

生成一个 HSL 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl()
...
(197, 57, 32)
(132, 90, 39)
(207, 76, 65)
(183, 88, 33)
(258, 62, 73)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl(hue='red', luminosity='dark')
...
(358, 92, 27)
(350, 96, 33)
(359, 88, 36)
(356, 98, 28)
(6, 85, 34)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsl(hue=(100, 200), luminosity='random')
...
(149, 94, 27)
(105, 23, 54)
(162, 100, 74)
(138, 43, 31)
(174, 19, 55)

生成一个 HSV 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv()
...
(197, 73, 51)
(132, 95, 76)
(207, 58, 92)
(183, 94, 64)
(258, 37, 90)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv(hue='red', luminosity='dark')
...
(358, 96, 53)
(350, 98, 66)
(359, 94, 68)
(356, 99, 56)
(6, 92, 63)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_hsv(hue=(100, 200), luminosity='random')
...
(149, 97, 53)
(105, 33, 65)
(162, 51, 100)
(138, 61, 45)
(174, 27, 64)

color_name() → str¶

生成一个颜色名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'Золотой'
'Цвет морской волны'
'Зеленый'
'Лазурный'
'Темный хаки'

生成一个整数 RGB 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb()
...
(35, 103, 130)
(9, 193, 46)
(98, 173, 234)
(9, 155, 163)
(170, 144, 229)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb(hue='red', luminosity='dark')
...
(135, 5, 9)
(168, 3, 30)
(173, 10, 13)
(142, 1, 10)
(160, 27, 12)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb(hue=(100, 200), luminosity='random')
...
(4, 135, 67)
(124, 165, 111)
(124, 255, 215)
(44, 114, 65)
(119, 163, 158)

生成一个浮点数 RGB 颜色元组。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float()
...
(0.13770000000000002, 0.4045149999999999, 0.51)
(0.038000000000000034, 0.76, 0.18239999999999984)
(0.3864000000000001, 0.6798800000000002, 0.92)
(0.03840000000000004, 0.6099200000000001, 0.64)
(0.6668999999999999, 0.5670000000000001, 0.9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float(hue='red', luminosity='dark')
...
(0.53, 0.02120000000000002, 0.03815999999999998)
(0.66, 0.013200000000000012, 0.12100000000000023)
(0.68, 0.04080000000000004, 0.05145333333333333)
(0.56, 0.005600000000000005, 0.042559999999999855)
(0.63, 0.10835999999999996, 0.05039999999999997)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_rgb_float(hue=(100, 200), luminosity='random')
...
(0.015900000000000015, 0.53, 0.2643816666666667)
(0.489125, 0.65, 0.43549999999999994)
(0.49, 1.0, 0.8470000000000001)
(0.17550000000000002, 0.45, 0.2578500000000001)
(0.4672, 0.64, 0.62272)

hex_color() → str¶

生成一个十六进制三元组格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hex_color()
...
'#d82c08'
'#629f70'
'#c2094d'
'#e3e707'
'#6baa95'

rgb_color() → str¶

生成一个逗号分隔的 RGB 值格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rgb_color()
...
'197,215,20'
'132,248,207'
'155,244,183'
'111,71,144'
'71,48,128'

rgb_css_color() → str¶

生成一个 CSS rgb() 函数格式的颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.rgb_css_color()
...
'rgb(197,215,20)'
'rgb(132,248,207)'
'rgb(155,244,183)'
'rgb(111,71,144)'
'rgb(71,48,128)'

safe_color_name() → str¶

生成一个网络安全颜色名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_color_name()
...
'lime'
'белый'
'lime'
'черный'
'пурпурный'

safe_hex_color() → str¶

生成一个十六进制三元组格式的网络安全颜色。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_hex_color()
...
'#ccdd11'
'#88ffcc'
'#99ffbb'
'#664499'
'#443388'

`faker.providers.company`¶

class faker.providers.company.ru_RU.Provider(generator: Any)¶

Bases: Provider

bs() → str¶

示例:: ‘integrate extensible convergence’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'Переосмысление современных порталов'
'Включение интерактивных систем'
'Развитие масштабируемых ниш'
'Производство круглогодичных функций'
'Модернизация передовых интернет-компаний'

businesses_inn() → str¶

Returns tax identification number for businesses (ru. идентификационный номер налогоплательщика, ИНН).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.businesses_inn()
...
'5098551265'
'0634670140'
'6352397567'
'6246764663'
'2865182552'

businesses_ogrn() → str¶

Returns primary state registration number for businesses (ru. основной государственный регистрационный номер, ОГРН).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.businesses_ogrn()
...
'5255406792163'
'5176367936685'
'5164697875271'
'1171847284553'
'1251342027991'

catch_phrase() → str¶

示例:: ‘Адаптивный и масштабируемый графический интерфейс’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'Прочная и веб-ориентированная модель'
'Сосредоточенная и целостная база знаний'
'Организованная и ультрасовременная парадигма'
'Управляемая и масштабируемая локальная сеть'
'Интуитивная и нейтральная стандартизация'

company() → str¶

示例:: ‘Acme Ltd’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'ОАО «Брагина, Одинцов и Федоров»'
'ЗАО «Лыткин-Корнилов»'
'НПО «Терентьев-Пономарева»'
'ЗАО «Матвеев Воронцов»'
'ОАО «Пономарев Осипова»'

company_prefix() → str¶

示例:: ‘ООО’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_prefix()
...
'ОАО'
'НПО'
'ОАО'
'НПО'
'РАО'

company_suffix() → str¶

示例:: ‘Ltd’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'Групп'
'Групп'
'Инк'
'и партнеры'
'Лтд'

individuals_inn() → str¶

Returns tax identification number for individuals (ru. идентификационный номер налогоплательщика, ИНН).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.individuals_inn()
...
'509893348943'
'540627149425'
'666342460503'
'396237544280'
'752852920309'

individuals_ogrn() → str¶

Returns primary state registration number for individuals (ru. основной государственный регистрационный номер, ОГРН).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.individuals_ogrn()
...
'313540434697742'
'309665217608901'
'313395117420821'
'312759574133436'
'307651495440078'

kpp() → str¶

Returns tax registration reason code (ru. код причины постановки на учет, КПП).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.kpp()
...
'509845042'
'346645415'
'396244598'
'286543289'
'189701634'

large_company() → str¶

示例:: ‘АвтоВАЗ’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.large_company()
...
'Продо'
'НМЖК'
'Банковский холдинг Альфа-банка'
'Р-Фарм'
'Крок инкорпорейтед'

snils() → str¶

Returns SNILS number (ru. СНИЛС).

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.snils()
...
'90669106018'
'41365400041'
'81384734012'
'95589212971'
'45158530283'

`faker.providers.credit_card`¶

class faker.providers.credit_card.ru_RU.Provider(generator: Any)¶

Bases: Provider

Implement credit card provider for ru_RU locale.

For all methods that take card_type as an argument, a random card type will be used if the supplied value is None. The list of valid card types includes 'amex', 'maestro', 'mastercard', 'mir', 'unionpay', and 'visa'.

来源

https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)

生成信用卡有效期。

This method uses date_time_between() under the hood to generate the expiry date, so the start and end arguments work in the same way here as it would in that method. For the actual formatting of the expiry date, strftime() is used and date_format is simply passed to that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_expire()
...
'05/34'
'07/33'
'03/30'
'07/28'
'01/31'

credit_card_full(card_type: CardType | None = None) → str¶

生成一整套信用卡详细信息。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_full()
...
'Maestro\nAlina Osipova\n6376475938242192 12/33\nCVV2: 892\nКС Банк'
'Visa\nMaksimilyan Voronov\n4565938778408013 02/33\nCVV2: 609\nПриобье'
'МИР\nLyubosmysl Kryukov\n2200393328711588 12/35\nCVC: 714\nРосэксимбанк'
'МИР\nTrofim Mironov\n2204398947196596 05/28\nCVC: 232\nАкцепт'
'American Express\nOlimpiada Vinogradova\n342201868483398 03/34\nCID: 6947\nПриобье'

credit_card_number(card_type: CardType | None = None) → str¶

生成有效的信用卡号。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_number()
...
'6760487647593827'
'2201194892411574'
'345659387784082'
'4609753513933284'
'5615871484185830'

credit_card_provider(card_type: CardType | None = None) → str¶

生成信用卡提供商名称。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_provider()
...
'Maestro'
'Maestro'
'Visa'
'МИР'
'American Express'

credit_card_security_code(card_type: CardType | None = None) → str¶

生成信用卡安全码。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.credit_card_security_code()
...
'604'
'7647'
'938'
'421'
'4892'

`faker.providers.currency`¶

class faker.providers.currency.ru_RU.Provider(generator: Any)¶

Bases: Provider

cryptocurrency() → Tuple[str, str]¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency()
...
('XRP', 'Ripple')
('STC', 'SwiftCoin')
('BC', 'BlackCoin')
('NXT', 'Nxt')
('IOTA', 'IOTA')

cryptocurrency_code() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_code()
...
'XRP'
'STC'
'BC'
'NXT'
'IOTA'

cryptocurrency_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.cryptocurrency_name()
...
'Ripple'
'SwiftCoin'
'BlackCoin'
'Nxt'
'IOTA'

currency() → Tuple[str, str]¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('MWK', 'Квача')
('NZD', 'Новозеландский доллар')
('BAM', 'Конвертируемая марка Боснии и Герцеговины')
('IRR', 'Иранский риал')
('SPL', 'Луиджино')

currency_code() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_code()
...
'MWK'
'NZD'
'BAM'
'IRR'
'SPL'

currency_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Квача'
'Новозеландский доллар'
'Конвертируемая марка Боснии и Герцеговины'
'Иранский риал'
'Луиджино'

currency_symbol(code: str | None = None) → str¶

示例:: $
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_symbol()
...
'$'
'$'
'KM'
'kr'
'L'

pricetag() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pricetag()
...
'7 604,87\xa0р.'
'975,93\xa0р.'
'54,21\xa0р.'
'89 241,15\xa0р.'
'91 565,93\xa0р.'

`faker.providers.date_time`¶

class faker.providers.date_time.ru_RU.Provider(generator: Any)¶

Bases: Provider

am_pm() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.am_pm()
...
'AM'
'AM'
'PM'
'PM'
'AM'

century() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XIII'
'XIV'
'II'
'IX'
'XVII'

获取一个介于 1970 年 1 月 1 日和现在之间的日期字符串。

参数:

pattern – 日期格式（默认为年-月-日）
end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2017-04-02'
'2012-05-31'
'1993-07-14'
'1984-06-27'
'1998-08-11'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'04/02/2017'
'05/31/2012'
'07/14/1993'
'06/27/1984'
'08/11/1998'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2017-04-08'
'2012-06-05'
'1993-07-17'
'1984-06-29'
'1998-08-15'

获取一个基于两个给定日期之间随机日期的 Date 对象。接受可被 strtotime() 识别的日期字符串。

参数:

start_date – 一个 DateParseType。默认为 30 年前
end_date – 一个 DateParseType。默认为 "today"

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 4, 16)
datetime.date(2018, 9, 11)
datetime.date(2008, 7, 28)
datetime.date(2003, 9, 22)
datetime.date(2011, 4, 18)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1w')
...
datetime.date(2025, 12, 14)
datetime.date(2025, 12, 14)
datetime.date(2025, 12, 11)
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 12)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2025, 10, 25)
datetime.date(2025, 9, 23)
datetime.date(2025, 5, 20)
datetime.date(2025, 3, 21)
datetime.date(2025, 6, 23)

获取两个给定日期之间的随机日期。

参数:

date_start – 一个 DateParseType。默认为 UNIX 纪元时间
date_end – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)
datetime.date(2025, 12, 16)

date_object(end_datetime: datetime | None = None) → date¶

获取一个介于 1970 年 1 月 1 日和现在之间的 date 对象

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2017, 4, 2)
datetime.date(2012, 5, 31)
datetime.date(1993, 7, 14)
datetime.date(1984, 6, 27)
datetime.date(1998, 8, 11)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2017, 4, 8)
datetime.date(2012, 6, 5)
datetime.date(1993, 7, 17)
datetime.date(1984, 6, 29)
datetime.date(1998, 8, 15)

date_of_birth(tzinfo: tzinfo | None = None, minimum_age: int = 0, maximum_age: int = 115) → date¶

生成一个随机的出生日期，表示为一个 Date 对象，受可选的 minimum_age 和 maximum_age 参数限制。

参数:

tzinfo – 默认为 None。
minimum_age – 默认为 0。
maximum_age – 默认为 115。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2007, 11, 29)
datetime.date(1997, 11, 17)
datetime.date(1958, 9, 29)
datetime.date(1939, 12, 29)
datetime.date(1969, 4, 7)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1992, 9, 8)
datetime.date(1990, 11, 15)
datetime.date(1983, 10, 15)
datetime.date(1980, 5, 23)
datetime.date(1985, 9, 10)

date_this_century(before_today: bool = True, after_today: bool = False) → date¶

获取当前世纪的 Date 对象。

参数:

before_today – 包括今天之前的当前世纪日期。默认为 True
after_today – 包括今天之后的当前世纪日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2021, 12, 1)
datetime.date(2019, 9, 4)
datetime.date(2010, 12, 1)
datetime.date(2006, 9, 20)
datetime.date(2013, 4, 9)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century(before_today=False, after_today=True)
...
datetime.date(2088, 6, 24)
datetime.date(2082, 1, 29)
datetime.date(2057, 2, 4)
datetime.date(2045, 2, 16)
datetime.date(2063, 10, 24)

date_this_decade(before_today: bool = True, after_today: bool = False) → date¶

获取当前十年的 Date 对象。

参数:

before_today – 包括今天之前的当前十年日期。默认为 True
after_today – 包括今天之后的当前十年日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2025, 1, 11)
datetime.date(2024, 7, 7)
datetime.date(2022, 7, 4)
datetime.date(2021, 7, 17)
datetime.date(2023, 1, 17)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 5, 16)
datetime.date(2029, 1, 8)
datetime.date(2027, 8, 29)
datetime.date(2027, 1, 2)
datetime.date(2028, 1, 10)

date_this_month(before_today: bool = True, after_today: bool = False) → date¶

获取当前月份的 Date 对象。

参数:

before_today – 包括今天之前的当前月份日期。默认为 True
after_today – 包括今天之后的当前月份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2025, 12, 13)
datetime.date(2025, 12, 12)
datetime.date(2025, 12, 7)
datetime.date(2025, 12, 4)
datetime.date(2025, 12, 8)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)

date_this_year(before_today: bool = True, after_today: bool = False) → date¶

获取当前年份的 Date 对象。

参数:

before_today – 包括今天之前的当前年份日期。默认为 True
after_today – 包括今天之后的当前年份日期。默认为 False

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2025, 10, 22)
datetime.date(2025, 9, 22)
datetime.date(2025, 5, 27)
datetime.date(2025, 4, 1)
datetime.date(2025, 6, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 28)
datetime.date(2025, 12, 22)
datetime.date(2025, 12, 20)
datetime.date(2025, 12, 24)

获取一个介于 1970 年 1 月 1 日和指定 end_datetime 之间的 datetime 对象

参数:

tzinfo – 时区，datetime.tzinfo 子类的实例
end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 4, 2, 7, 9, 55, 680357)
datetime.datetime(2012, 5, 31, 1, 49, 57, 465987)
datetime.datetime(1993, 7, 14, 15, 27, 50, 941758)
datetime.datetime(1984, 6, 27, 17, 48, 28, 963385)
datetime.datetime(1998, 8, 11, 10, 27, 19, 51441)

获取一个介于公元 0001 年 1 月 1 日和现在之间的 datetime 对象

参数:

tzinfo – 时区，datetime.tzinfo 子类的实例
end_datetime – 一个 DateParseType。默认为当前日期和时间
start_datetime – 一个 DateParseType。默认为 UNIX 时间戳 -62135596800，

相当于 0001-01-01 00:00:00 UTC

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1710, 12, 2, 9, 44, 51, 150215)
datetime.datetime(1535, 10, 30, 1, 56, 11, 349358)
datetime.datetime(852, 8, 21, 17, 50, 42, 985748)
datetime.datetime(525, 4, 18, 19, 55, 9, 933235)
datetime.datetime(1036, 4, 23, 18, 53, 0, 43644)

获取一个基于两个给定日期之间随机日期的 datetime 对象。接受可被 strtotime() 识别的日期字符串。

参数:

start_date – 一个 DateParseType。默认为 30 年前
end_date – 一个 DateParseType。默认为 "now"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 4, 16, 7, 18, 50, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 36, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 17, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 53, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 49, 171082)

获取两个给定 datetime 之间的随机 datetime。

参数:

datetime_start – 一个 DateParseType。默认为 UNIX 纪元时间
datetime_end – 一个 DateParseType。默认为当前日期和时间
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2025, 12, 16, 0, 8, 7)
datetime.datetime(2025, 12, 16, 0, 8, 7)
datetime.datetime(2025, 12, 16, 0, 8, 7)
datetime.datetime(2025, 12, 16, 0, 8, 7)
datetime.datetime(2025, 12, 16, 0, 8, 7)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2021, 4, 16, 7, 18, 50, 236214)
datetime.datetime(2018, 9, 11, 20, 43, 36, 808743)
datetime.datetime(2008, 7, 29, 2, 13, 17, 361449)
datetime.datetime(2003, 9, 22, 19, 23, 53, 49189)
datetime.datetime(2011, 4, 18, 22, 40, 49, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2026, 10, 20, 10, 8, 4, 441207)
datetime.datetime(2026, 9, 18, 20, 10, 53, 993625)
datetime.datetime(2026, 5, 18, 14, 45, 53, 345382)
datetime.datetime(2026, 3, 20, 13, 44, 14, 534973)
datetime.datetime(2026, 6, 20, 17, 50, 48, 405703)

date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前世纪的 datetime 对象。

参数:

before_now – 包括今天之前的当前世纪日期。默认为 True
after_now – 包括今天之后的当前世纪日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2021, 12, 1, 23, 14, 24, 53738)
datetime.datetime(2019, 9, 4, 4, 4, 45, 109328)
datetime.datetime(2010, 12, 1, 10, 35, 48, 57225)
datetime.datetime(2006, 9, 20, 18, 59, 16, 995641)
datetime.datetime(2013, 4, 9, 9, 33, 51, 707544)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 6, 24, 13, 5, 25, 114948)
datetime.datetime(2082, 1, 29, 2, 53, 8, 513561)
datetime.datetime(2057, 2, 4, 22, 35, 10, 865522)
datetime.datetime(2045, 2, 16, 3, 34, 13, 908881)
datetime.datetime(2063, 10, 24, 21, 59, 29, 998655)

date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前十年的 datetime 对象。

参数:

before_now – 包括今天之前的当前十年日期。默认为 True
after_now – 包括今天之后的当前十年日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 1, 11, 11, 12, 3, 620001)
datetime.datetime(2024, 7, 7, 7, 30, 47, 784750)
datetime.datetime(2022, 7, 4, 3, 59, 13, 672676)
datetime.datetime(2021, 7, 17, 9, 42, 12, 214736)
datetime.datetime(2023, 1, 17, 12, 52, 48, 766304)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 5, 16, 5, 5, 12, 620854)
datetime.datetime(2029, 1, 8, 12, 0, 1, 507746)
datetime.datetime(2027, 8, 29, 4, 29, 59, 211891)
datetime.datetime(2027, 1, 2, 10, 10, 52, 379328)
datetime.datetime(2028, 1, 10, 3, 43, 56, 772279)

date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前月份的 datetime 对象。

参数:

before_now – 包括今天之前的当前月份日期。默认为 True
after_now – 包括今天之后的当前月份日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2025, 12, 13, 16, 6, 21, 953018)
datetime.datetime(2025, 12, 12, 8, 57, 58, 30005)
datetime.datetime(2025, 12, 7, 7, 27, 45, 587117)
datetime.datetime(2025, 12, 4, 21, 14, 42, 200837)
datetime.datetime(2025, 12, 8, 16, 7, 41, 29683)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 44, 534106)
datetime.datetime(2025, 12, 28, 3, 5, 14, 42830)
datetime.datetime(2025, 12, 22, 17, 34, 40, 334981)
datetime.datetime(2025, 12, 20, 3, 31, 27, 423148)
datetime.datetime(2025, 12, 24, 4, 23, 44, 184031)

date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: tzinfo | None = None) → datetime¶

获取当前年份的 datetime 对象。

参数:

before_now – 包括今天之前的当前年份日期。默认为 True
after_now – 包括今天之后的当前年份日期。默认为 False
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2025, 10, 22, 16, 59, 29, 975587)
datetime.datetime(2025, 9, 22, 12, 43, 43, 8295)
datetime.datetime(2025, 5, 27, 18, 45, 52, 38101)
datetime.datetime(2025, 4, 1, 8, 43, 18, 214091)
datetime.datetime(2025, 6, 28, 10, 30, 22, 429050)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2025, 12, 29, 12, 16, 44, 534106)
datetime.datetime(2025, 12, 28, 3, 5, 14, 42830)
datetime.datetime(2025, 12, 22, 17, 34, 40, 334981)
datetime.datetime(2025, 12, 20, 3, 31, 27, 423148)
datetime.datetime(2025, 12, 24, 4, 23, 44, 184031)

day_of_month() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'02'
'31'
'14'
'27'
'11'

day_of_week() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'Воскресенье'
'Четверг'
'Среда'
'Среда'
'Вторник'

future_date(end_date: date | datetime | timedelta | str | int = '+30d') → date¶

获取一个基于从现在开始 1 天到给定日期之间的随机日期的 Date 对象。

参数:

end_date – 一个 DateParseType。默认为 "+30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2026, 1, 10)
datetime.date(2026, 1, 7)
datetime.date(2025, 12, 29)
datetime.date(2025, 12, 24)
datetime.date(2025, 12, 31)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2026, 10, 20)
datetime.date(2026, 9, 18)
datetime.date(2026, 5, 19)
datetime.date(2026, 3, 21)
datetime.date(2026, 6, 21)

获取一个基于从现在开始 1 秒到给定日期之间的随机日期的 datetime 对象。

参数:

end_date – 一个 DateParseType。默认为 "+30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2026, 1, 10, 8, 7, 8, 594731)
datetime.datetime(2026, 1, 7, 17, 51, 45, 54467)
datetime.datetime(2025, 12, 28, 14, 56, 49, 116942)
datetime.datetime(2025, 12, 23, 18, 33, 19, 957843)
datetime.datetime(2025, 12, 31, 8, 15, 11, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2026, 10, 20, 10, 8, 4, 596785)
datetime.datetime(2026, 9, 18, 20, 10, 54, 235670)
datetime.datetime(2026, 5, 18, 14, 45, 53, 924810)
datetime.datetime(2026, 3, 20, 13, 44, 15, 276056)
datetime.datetime(2026, 6, 20, 17, 50, 48, 894428)

获取 UNIX 纪元时间到现在之间的 ISO 8601 字符串。

参数:

tzinfo – 时区，datetime.tzinfo 子类的实例
end_datetime – 一个 DateParseType。默认为当前日期和时间
sep – 日期和时间之间的分隔符，默认为 'T'
timespec – 时间部分的格式说明符，默认为 'auto' - 请参阅 datetime.isoformat() 文档

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2017-04-02T07:09:55.680357'
'2012-05-31T01:49:57.465987'
'1993-07-14T15:27:50.941758'
'1984-06-27T17:48:28.963385'
'1998-08-11T10:27:19.051441'

month() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'04'
'05'
'07'
'06'
'08'

month_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'Апрель'
'Май'
'Июль'
'Июнь'
'Август'

获取一个基于给定日期和 1 天前之间的随机日期的 Date 对象。

参数:

start_date – 一个 DateParseType。默认为 "-30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2025, 12, 10)
datetime.date(2025, 12, 7)
datetime.date(2025, 11, 28)
datetime.date(2025, 11, 23)
datetime.date(2025, 11, 30)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date(start_date='-1y')
...
datetime.date(2025, 10, 19)
datetime.date(2025, 9, 17)
datetime.date(2025, 5, 17)
datetime.date(2025, 3, 19)
datetime.date(2025, 6, 19)

获取一个基于给定日期和 1 秒前之间的随机日期的 datetime 对象。

参数:

start_date – 一个 DateParseType。默认为 "-30d"
tzinfo – 时区，datetime.tzinfo 子类的实例

示例:

datetime(‘1999-02-02 11:42:52’)

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2025, 12, 11, 8, 7, 7, 594731)
datetime.datetime(2025, 12, 8, 17, 51, 44, 54467)
datetime.datetime(2025, 11, 28, 14, 56, 48, 116942)
datetime.datetime(2025, 11, 23, 18, 33, 18, 957843)
datetime.datetime(2025, 12, 1, 8, 15, 10, 566513)

pytimezone(*args: Any, **kwargs: Any) → tzinfo | None¶: 生成一个随机时区（有关任何参数，请参阅 faker.timezone），并返回一个可用作 datetime 或其他 faker 的 tzinfo 的 Python 对象。

获取一个时间字符串（默认为 24 小时格式）

参数:

pattern – 格式
end_datetime – 一个 DateParseType。默认为当前日期和时间

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:09:55'
'01:49:57'
'15:27:50'
'17:48:28'
'10:27:19'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'07:09 AM'
'01:49 AM'
'03:27 PM'
'05:48 PM'
'10:27 AM'

获取一个随机的 timedelta 对象，其持续时间介于当前日期时间和 end_datetime 之间

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta()
...
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)
datetime.timedelta(0)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_delta(end_datetime='+30h')
...
datetime.timedelta(days=1, seconds=4797, microseconds=559965)
datetime.timedelta(seconds=81859, microseconds=75518)
datetime.timedelta(seconds=45421, microseconds=730730)
datetime.timedelta(seconds=27963, microseconds=9032)
datetime.timedelta(seconds=55217, microseconds=669908)

获取一个 time 对象

参数:: end_datetime – 一个 DateParseType。默认为当前日期和时间
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 9, 55, 680357)
datetime.time(1, 49, 57, 465987)
datetime.time(15, 27, 50, 941758)
datetime.time(17, 48, 28, 963385)
datetime.time(10, 27, 19, 51441)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(8, 0, 35, 599023)
datetime.time(2, 35, 26, 101838)
datetime.time(15, 53, 4, 999449)
datetime.time(18, 4, 1, 63686)
datetime.time(10, 57, 59, 640438)

返回一个生成器，生成 (<datetime>, <value>) 元组。

数据点将从 start_date 开始，并按照 precision 指定的时间间隔生成。

参数:

start_date – 一个 DateParseType。默认为 "-30d"
end_date – 一个 DateParseType。默认为 "now"
precision – 一个浮点数，表示数据点之间的时间间隔。

默认为时间间隔的 1/30。:param distrib: 一个可调用对象，接受一个 datetime 对象并返回一个值。默认为均匀分布。:param tzinfo: 时区，datetime.tzinfo 子类的实例

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_series()
...
<generator object Provider.time_series at 0x7db9481f22d0>
<generator object Provider.time_series at 0x7db9481f22d0>
<generator object Provider.time_series at 0x7db9481f22d0>
<generator object Provider.time_series at 0x7db9481f22d0>
<generator object Provider.time_series at 0x7db9481f22d0>

timezone() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Мальдивы (UTC+05)'
'Барбадос (UTC-04)'
'Швеция (UTC+01)'
'Намибия (UTC+01)'
'Катар (UTC+03)'

获取一个介于 1970 年 1 月 1 日和现在之间的 Unix 时间戳，除非传递了明确的 start_datetime 或 end_datetime 值。

在 Windows 上，小数部分始终为 0。

参数:

end_datetime – 一个 DateParseType 类型。默认为 Unix 纪元。
start_datetime – 一个 DateParseType 类型。默认为当前日期和时间。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1491116995.6803575
1338428997.4659874
742663670.9417579
457206508.96338475
902831239.0514413

year() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'2017'
'2012'
'1993'
'1984'
'1998'

`faker.providers.internet`¶

class faker.providers.internet.ru_RU.Provider(generator: Any)¶

Bases: Provider

ascii_company_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'apotapova@ip.net'
'onufri2021@npo.com'
'visheslav_1985@zao.biz'
'larisa_2015@ip.ru'
'savva_81@npo.org'

ascii_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'qfedorov@litkin.edu'
'miron2002@zao.com'
'tverdislav92@hotmail.com'
'mjasnikovmaksimiljan@mail.ru'
'platon_59@rambler.ru'

ascii_free_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'apotapova@gmail.com'
'sokrat76@hotmail.com'
'miron2002@yahoo.com'
'visheslav_1985@gmail.com'
'tverdislav92@hotmail.com'

ascii_safe_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'apotapova@example.org'
'sokrat76@example.com'
'miron2002@example.org'
'visheslav_1985@example.org'
'tverdislav92@example.com'

company_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'apotapova@ip.net'
'onufri2021@npo.com'
'visheslav_1985@zao.biz'
'larisa_2015@ip.ru'
'savva_81@npo.org'

Generates a domain name by given date https://en.wikipedia.org/wiki/Domain_generation_algorithm

Return type:: str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.dga()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcmfsccynscisxeajjagjahtnfcmfscc.biz'
'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamo.edu'
'rsoitciyjatufbjfquyfvudjerivnsrsprechaalfphoqywwursulakiudm.net'
'ujkyfemsyj.biz'
'yastipdtwjouhjjorvdtvxkkhdirblaoisavobsvdnhimwbflybiwimdljso.biz'

domain_name(levels: int = 1) → str¶

Produce an Internet domain name with the specified number of subdomain levels.

>>> domain_name()
nichols-phillips.com
>>> domain_name(2)
williamson-hopkins.jackson.com

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'oao.biz'
'litkin.edu'
'npo.com'
'matveev.com'
'zao.biz'

domain_word() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'oao'
'zao'
'npo'
'zao'
'oao'

email(safe: bool = True, domain: str | None = None) → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'apotapova@example.org'
'sokrat76@example.com'
'miron2002@example.org'
'visheslav_1985@example.org'
'tverdislav92@example.com'

free_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'apotapova@gmail.com'
'sokrat76@hotmail.com'
'miron2002@yahoo.com'
'visheslav_1985@gmail.com'
'tverdislav92@hotmail.com'

free_email_domain() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'mail.ru'
'mail.ru'
'gmail.com'
'hotmail.com'
'yandex.ru'

hostname(levels: int = 1) → str¶

Produce a hostname with specified number of subdomain levels.

>>> hostname()
db-01.nichols-phillips.com
>>> hostname(0)
laptop-56
>>> hostname(2)
web-12.williamson-hopkins.jackson.com

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.ip.net'
'laptop-64.ip.com'
'lt-24.oao.edu'
'desktop-89.ip.ru'
'web-57.medvedev.info'

http_method() → str¶

Returns random HTTP method https://mdn.org.cn/en-US/docs/Web/HTTP/Methods

Return type:: str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_method()
...
'OPTIONS'
'OPTIONS'
'GET'
'DELETE'
'PATCH'

http_status_code(include_unassigned: bool = True) → int¶

Returns random HTTP status code https://www.rfc-editor.org/rfc/rfc9110#name-status-codes :param include_unassigned: Whether to include status codes which have

not yet been assigned or are unused

Returns:: a random three digit status code
Return type:: int
示例:: 404
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_status_code()
...
532
297
488
555
315

iana_id() → str¶

Returns IANA Registrar ID https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml

Return type:: str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iana_id()
...
'6463344'
'7056021'
'679216'
'4343903'
'8577767'

image_url(width: int | None = None, height: int | None = None, placeholder_url: str | None = None) → str¶

Returns URL to placeholder image Example: http://placehold.it/640x480

参数:

width – Optional image width
height – Optional image height
placeholder_url – Optional template string of image URLs from custom placeholder service. String must contain {width} and {height} placeholders, eg: https:/example.com/{width}/{height}.

Return type:

str

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.image_url()
...
'https://picsum.photos/788/861'
'https://dummyimage.com/530x995'
'https://dummyimage.com/621x976'
'https://dummyimage.com/447x285'
'https://placekitten.com/286/194'

ipv4(network: bool = False, address_class: str | None = None, private: str | None = None) → str¶

Returns a random IPv4 address or network with a valid CIDR.

参数:

network – Network address
address_class – IPv4 address class (a, b, or c)
private – Public or private

Returns:

IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4()
...
'171.174.170.81'
'95.25.112.121'
'51.105.121.194'
'195.110.164.126'
'141.250.247.54'

ipv4_network_class() → str¶

Returns a IPv4 network class ‘a’, ‘b’ or ‘c’.

Returns:: IPv4 network class
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_network_class()
...
'b'
'b'
'a'
'b'
'c'

ipv4_private(network: bool = False, address_class: str | None = None) → str¶

Returns a private IPv4.

参数:

network – Network address
address_class – IPv4 address class (a, b, or c)

Returns:

Private IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_private()
...
'172.29.117.82'
'10.248.203.131'
'172.25.180.188'
'172.22.253.123'
'192.168.71.140'

ipv4_public(network: bool = False, address_class: str | None = None) → str¶

Returns a public IPv4 excluding private blocks.

参数:

network – Network address
address_class – IPv4 address class (a, b, or c)

Returns:

Public IPv4

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_public()
...
'166.186.169.69'
'111.198.92.30'
'168.155.75.206'
'141.250.247.54'
'212.120.204.37'

ipv6(network: bool = False) → str¶

Produce a random IPv6 address or network with a valid CIDR

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv6()
...
'e3e7:682:c209:4cac:629f:6fbf:d82c:7cd'
'f728:b4fa:4248:5e3a:a5d:2f35:6baa:9455'
'eb11:67b3:67a9:c378:7c65:c1e6:82e2:e662'
'f7c1:bd87:4da5:e709:d471:3d61:c8a7:639'
'e443:df78:9558:867f:5ba9:1fb0:7a02:4204'

mac_address(multicast: bool = False) → str¶

Returns a random MAC address.

参数:: multicast – Multicast address
Returns:: MAC Address
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mac_address()
...
'66:c5:d7:14:84:f8'
'48:9b:f4:b7:6f:47'
'18:47:30:80:4b:9e'
'6e:25:a9:f1:33:b5'
'0e:a1:68:f4:e2:85'

nic_handle(suffix: str = 'FAKE') → str¶

Returns NIC Handle ID https://www.apnic.net/manage-ip/using-whois/guide/person/

Return type:: str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handle()
...
'ZYT1598-FAKE'
'SIW493-FAKE'
'UE59352-FAKE'
'WBUN892-FAKE'
'CHQD98-FAKE'

nic_handles(count: int = 1, suffix: str = '????') → List[str]¶

Returns NIC Handle ID list

Return type:: list[str]
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handles()
...
['ZYT1598-EWLN']
['WGNZ53-QITZ']
['UERV52-EJGW']
['CHQ498-DZJA']
['UU1864-TEMK']

port_number(is_system: bool = False, is_user: bool = False, is_dynamic: bool = False) → int¶

Returns a network port number https://tools.ietf.org/html/rfc6335

参数:

is_system – System or well-known ports
is_user – User or registered ports
is_dynamic – Dynamic / private / ephemeral ports

Return type:

int

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.port_number()
...
50494
55125
5306
33936
63691

ripe_id() → str¶

Returns RIPE Organization ID https://www.ripe.net/manage-ips-and-asns/db/support/organisation-object-in-the-ripe-database

Return type:: str
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ripe_id()
...
'ORG-ZYT1598-RIPE'
'ORG-SIW493-RIPE'
'ORG-UE59352-RIPE'
'ORG-WBUN892-RIPE'
'ORG-CHQD98-RIPE'

safe_domain_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_domain_name()
...
'example.com'
'example.com'
'example.org'
'example.com'
'example.net'

safe_email() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'apotapova@example.org'
'sokrat76@example.com'
'miron2002@example.org'
'visheslav_1985@example.org'
'tverdislav92@example.com'

slug(value: str | None = None) → str¶

Django algorithm

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'three-image-son'
'kitchen-amount'
'much-mention'
'why-step-themselves'
'me-help-past-wait'

tld() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'edu'
'info'
'edu'
'info'
'ru'

uri(schemes: List[str] | None = None, deep: int | None = None) → str¶

参数:

schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https uris. Passing an empty list will result in schemeless uri generation like “://domain.com/index.html”.
deep – an integer specifying how many path components the URI should have..

Returns:

a random url string.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://oao.info/categorylogin.jsp'
'https://www.kudrjashova.com/main/main/mainprivacy.htm'
'https://www.npo.org/app/list/searchlogin.html'
'http://rao.edu/list/searchprivacy.asp'
'https://www.zao.edu/tag/list/wp-contenthomepage.html'

uri_extension() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_extension()
...
'.php'
'.php'
'.html'
'.htm'
'.asp'

uri_page() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'author'
'category'
'privacy'
'category'
'index'

uri_path(deep: int | None = None) → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'blog'
'category'

url(schemes: List[str] | None = None) → str¶

参数:: schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https urls. Passing an empty list will result in schemeless url generation like “://domain.com”.
Returns:: a random url string.
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://ip.net/'
'https://npo.com/'
'http://oao.edu/'
'https://www.rao.edu/'
'https://medvedev.info/'

user_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'apotapova'
'osipovaraisa'
'onufri2021'
'samson59'
'silantikudrjavtsev'

`faker.providers.job`¶

class faker.providers.job.ru_RU.Provider(generator: Any)¶

Bases: Provider

job() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Санитар'
'Страховой агент'
'Бондарь'
'Механик-Водитель'
'Шорник'

job_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Санитар'
'Страховой агент'
'Бондарь'
'Механик-Водитель'
'Шорник'

job_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Санитар'
'Страховой агент'
'Бондарь'
'Механик-Водитель'
'Шорник'

`faker.providers.lorem`¶

class faker.providers.lorem.ru_RU.Provider(generator: Any)¶

Bases: Provider

Implement lorem provider for ru_RU locale.

get_words_list(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) → List[str]¶

获取单词列表。

ext_word_list 参数允许用户提供一个单词列表来代替内置的单词列表。如果提供了 ext_word_list，则忽略 part_of_speech 的值。

part_of_speech 参数定义了返回的单词所属的词性。如果 ext_word_list 不是 None，则忽略 part_of_speech。如果 part_of_speech 的值与当前区域设置中存在的词性不对应，则会引发异常。

警告

根据区域提供者内置单词列表的长度或提供的 ext_word_list 的长度，如果 unique 为 True，较大的 nb 可能会耗尽这些列表，从而引发异常。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.get_words_list(part_of_speech="abc", ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.get_words_list(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']
['abc', 'def', 'ghi', 'jkl']

paragraph(nb_sentences: int = 3, variable_nb_sentences: bool = True, ext_word_list: Sequence[str] | None = None) → str¶

生成一个段落。

The nb_sentences argument controls how many sentences the paragraph will contain, and setting variable_nb_sentences to False will generate the exact amount, while setting it to True (default) will generate a random amount (+/-40%, minimum of 1) using randomize_nb_elements().

Under the hood, sentences() is used to generate the sentences, so the argument ext_word_list works in the same way here as it would in that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5)
...
'Грустный полностью умирать набор командующий покинуть. Сынок некоторый функция ягода июнь разуметься. Хозяйка рай предоставить трубка табак. Передо прошептать витрина висеть. Пища чувство жестокий издали.'
'Покидать интеллектуальный народ набор видимо прощение пространство. Войти функция страсть провинция неправда роскошный вздрогнуть посидеть. Сустав мгновение поговорить пространство еврейский. Увеличиваться космос миг район приличный возникновение райком. Актриса подробность угроза художественный миллиард. Чувство провинция пробовать житель мучительно один.'
'Коммунизм столетие кузнец число миф господь добиться. Витрина слать господь интеллектуальный дьявол космос столетие. Выразить лапа подземный увеличиваться валюта порог. Неправда освободить угроза степь.'
'Вздрагивать зачем предоставить угроза очко. Багровый даль табак металл мера лететь. Подробность плод приличный упорно кидать проход пространство. Фонарик порт уточнить дошлый.'
'Крыса смелый пропаганда точно социалистический даль настать. Решение миг отметить рот пропасть. Даль носок выбирать успокоиться назначить горький набор бок.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
...
'Бетонный второй настать расстройство наступать ложиться. Покинуть успокоиться плясать поезд кольцо. Июнь разуметься сверкать некоторый. Рота полюбить передо прошептать витрина висеть даль результат. Жестокий издали механический покидать интеллектуальный народ набор видимо.'
'Сходить потрясти неправда карандаш. Засунуть командующий возникновение. Четко народ валюта находить сустав мгновение. Правый господь карман зарплата изредка спорт домашний. Помимо багровый магазин актриса.'
'Помимо естественный пространство граница чувство провинция пробовать житель. Цель разводить единый. Столетие кузнец число миф. Прошептать райком магазин при. Необычный конструкция торговля дрогнуть оставить командир выразить.'
'Функция жестокий сутки а секунда неправда освободить. Приятель мусор провинция назначить совет находить зеленый возникновение. Даль табак металл мера. Академик пропаганда подробность плод приличный упорно кидать. При потянуться один фонарик.'
'Танцевать мотоцикл сходить. Крыса смелый пропаганда точно социалистический даль настать. Решение миг отметить рот пропасть. Даль носок выбирать успокоиться назначить горький набор бок. Покинуть забирать четыре мусор жидкий.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc. Ghi jkl ghi def. Def def ghi abc.'
'Def ghi abc jkl jkl abc jkl. Abc def jkl abc def jkl abc ghi. Jkl abc ghi abc jkl. Jkl def def def abc def jkl. Jkl ghi ghi def ghi. Def abc abc jkl abc jkl.'
'Abc ghi abc abc abc abc ghi. Ghi jkl ghi ghi abc abc ghi. Ghi def ghi jkl jkl jkl. Def abc ghi def.'
'Abc def ghi def abc. Jkl abc abc ghi abc ghi. Ghi abc abc abc jkl abc abc. Abc abc jkl abc.'
'Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl. Jkl def jkl abc abc. Jkl ghi def jkl. Jkl def ghi jkl ghi def abc def. Ghi abc ghi def ghi abc jkl jkl.'
'Ghi def jkl ghi. Ghi jkl def. Ghi abc jkl abc jkl abc. Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.'
'Ghi def abc jkl def abc abc jkl. Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def. Def jkl jkl jkl ghi jkl ghi.'
'Def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl. Def def jkl abc.'
'Abc jkl ghi. Abc jkl jkl abc def abc def. Abc def def abc def. Abc jkl abc def ghi jkl jkl abc. Jkl abc ghi jkl def.'

paragraphs(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]¶

生成一个段落列表。

This method uses paragraph() under the hood to generate paragraphs, and the nb argument controls exactly how many sentences the list will contain. The ext_word_list argument works in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5)
...
['Грустный полностью умирать набор командующий покинуть. Сынок некоторый функция ягода июнь разуметься. Хозяйка рай предоставить трубка табак.', 'Прошептать витрина висеть даль. Чувство жестокий издали механический покидать интеллектуальный.', 'Видимо прощение пространство бригада инструкция постоянный засунуть. Провинция неправда роскошный вздрогнуть посидеть спасть.', 'Правый господь карман зарплата изредка спорт домашний. Помимо багровый магазин актриса.', 'Угроза художественный миллиард ныне невозможно район упорно. Мучительно один блин коммунизм. Заведение райком провал прошептать. Витрина слать господь интеллектуальный дьявол космос столетие.']
['Необычный функция жестокий сутки а секунда неправда освободить. Приятель мусор провинция назначить совет находить зеленый возникновение. Даль табак металл мера.', 'Подробность плод приличный упорно кидать проход пространство. Фонарик порт уточнить дошлый. Выкинуть бак рот столетие.', 'Приходить лиловый решение решение миг отметить. Медицина миф даль носок. Блин песня что рота славный.', 'Решетка идея что спичка. Миллиард покидать советовать что.', 'Костер валюта коллектив реклама разводить тяжелый недостаток. Уронить степь мера ягода кожа казнь пища. Означать цвет плясать место неожиданно.']
['Перебивать командующий господь парень добиться что. Металл стакан костер славный девка.', 'Головной пламя пастух художественный настать салон смертельный. Некоторый подробность войти миф неправда слать факультет. Упорно равнодушный процесс болото банк хозяйка.', 'Чувство лететь пересечь монета товар спичка. Вздрогнуть угодный выбирать триста. Даль место дальний господь.', 'Ставить освободить дружно устройство военный банда освободить. Труп куча грустный разнообразный.', 'Печатать остановить некоторый опасность перебивать сутки. Мелочь рота жестокий угроза чем запустить угроза. Кольцо зачем возбуждение.']
['Деловой приходить грустный светило. Юный премьера построить скрытый выкинуть спасть факультет помолчать. Передо триста лиловый палата спорт тесно мрачно.', 'Приличный совет оборот фонарик степь команда. Набор анализ растеряться указанный. Соответствие инфекция перебивать рот.', 'Школьный инвалид висеть космос.', 'Князь падать носок блин выражение. Вздрогнуть освободить житель место изба господь. Проход дальний запустить опасность печатать. Совещание близко серьезный вряд материя.', 'А число наступать столетие заведение поставить валюта деньги. Равнодушный академик костер поговорить волк экзамен предоставить.']
['Изображать число дружно инструкция провал сынок. Тута инфекция виднеться миф горький грустный приятель. Отъезд что число разводить сверкающий функция беспомощный.', 'Лететь столетие роса. Написать да песня запустить одиннадцать горький неправда выгнать. Непривычный уничтожение потом порт мальчишка уронить.', 'Очутиться возникновение функция степь неправда сопровождаться ныне. Народ жестокий ярко естественный командующий другой.', 'Выражаться природа коричневый пересечь означать изучить хозяйка.', 'Засунуть пол пастух. Угол порт горький неожиданно деньги сутки коллектив. Кпсс выражение природа слишком засунуть.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.paragraphs(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.', 'Jkl ghi def abc. Def ghi abc ghi def ghi.', 'Jkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.']
['Def def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.', 'Ghi abc abc abc jkl abc abc. Abc abc jkl abc. Def ghi abc ghi.', 'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.', 'Jkl abc abc ghi. Ghi def abc def.', 'Jkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.']
['Ghi jkl abc ghi ghi abc. Ghi def jkl ghi def.', 'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.', 'Def abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.', 'Jkl abc def ghi jkl ghi abc. Def abc abc ghi.', 'Jkl jkl jkl abc ghi ghi. Ghi jkl ghi def ghi abc ghi. Abc def def.']
['Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.', 'Abc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.', 'Def ghi def def.', 'Def def jkl def jkl. Abc abc jkl jkl abc ghi. Abc def abc abc jkl. Ghi abc def def jkl.', 'Jkl abc def ghi jkl def jkl def. Jkl ghi jkl ghi jkl abc ghi.']
['Abc abc def jkl jkl ghi. Abc abc jkl abc abc abc abc. Def abc abc ghi jkl ghi jkl.', 'Ghi ghi jkl. Jkl ghi jkl abc ghi ghi jkl def. Ghi abc jkl abc jkl ghi.', 'Ghi def def def jkl jkl def. Abc ghi abc def jkl abc.', 'Def def jkl ghi ghi abc jkl.', 'Ghi def abc. Jkl abc ghi abc def ghi ghi. Def jkl def jkl ghi.']

sentence(nb_words: int = 6, variable_nb_words: bool = True, ext_word_list: Sequence[str] | None = None) → str¶

生成一个句子。

The nb_words argument controls how many words the sentence will contain, and setting variable_nb_words to False will generate the exact amount, while setting it to True (default) will generate a random amount (+/-40%, minimum of 1) using randomize_nb_elements().

Under the hood, words() is used to generate the words, so the argument ext_word_list works in the same way here as it would in that method.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10)
...
'Бетонный второй настать расстройство наступать ложиться триста единый сынок некоторый.'
'Кольцо кольцо прежде ставить хозяйка рай предоставить трубка табак ленинград плод монета.'
'Висеть даль результат засунуть нажать покинуть единый потом блин роса.'
'Видимо прощение пространство бригада инструкция постоянный засунуть командующий возникновение назначить четко народ валюта.'
'Спасть покинуть сустав правый господь карман зарплата изредка.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=False)
...
'Мусор бетонный второй настать расстройство наступать ложиться триста единый сынок.'
'Некоторый функция ягода июнь разуметься сверкать некоторый а конструкция рота.'
'Полюбить передо прошептать витрина висеть даль результат засунуть нажать покинуть.'
'Единый потом блин роса построить приятель сходить потрясти неправда карандаш.'
'Войти функция страсть провинция неправда роскошный вздрогнуть посидеть спасть покинуть.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl def def ghi jkl.'
'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
'Def abc def ghi jkl jkl def jkl def jkl.'
'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
'Abc jkl jkl def abc def ghi jkl.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentence(nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Jkl def def ghi def jkl def def ghi jkl.'
'Abc abc abc jkl jkl ghi ghi ghi abc abc abc jkl.'
'Def abc def ghi jkl jkl def jkl def jkl.'
'Jkl abc jkl ghi jkl ghi ghi jkl def ghi ghi abc jkl.'
'Abc jkl jkl def abc def ghi jkl.'

sentences(nb: int = 3, ext_word_list: Sequence[str] | None = None) → List[str]¶

生成一个句子列表。

This method uses sentence() under the hood to generate sentences, and the nb argument controls exactly how many sentences the list will contain. The ext_word_list argument works in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences()
...
['Бетонный второй настать расстройство наступать ложиться.', 'Покинуть успокоиться плясать поезд кольцо.', 'Июнь разуметься сверкать некоторый.']
['Рота полюбить передо прошептать витрина висеть даль результат.', 'Жестокий издали механический покидать интеллектуальный народ набор видимо.', 'Сходить потрясти неправда карандаш.']
['Засунуть командующий возникновение.', 'Четко народ валюта находить сустав мгновение.', 'Правый господь карман зарплата изредка спорт домашний.']
['Помимо багровый магазин актриса.', 'Помимо естественный пространство граница чувство провинция пробовать житель.', 'Цель разводить единый.']
['Столетие кузнец число миф.', 'Прошептать райком магазин при.', 'Необычный конструкция торговля дрогнуть оставить командир выразить.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5)
...
['Бетонный второй настать расстройство наступать ложиться.', 'Покинуть успокоиться плясать поезд кольцо.', 'Июнь разуметься сверкать некоторый.', 'Рота полюбить передо прошептать витрина висеть даль результат.', 'Жестокий издали механический покидать интеллектуальный народ набор видимо.']
['Сходить потрясти неправда карандаш.', 'Засунуть командующий возникновение.', 'Четко народ валюта находить сустав мгновение.', 'Правый господь карман зарплата изредка спорт домашний.', 'Помимо багровый магазин актриса.']
['Помимо естественный пространство граница чувство провинция пробовать житель.', 'Цель разводить единый.', 'Столетие кузнец число миф.', 'Прошептать райком магазин при.', 'Необычный конструкция торговля дрогнуть оставить командир выразить.']
['Функция жестокий сутки а секунда неправда освободить.', 'Приятель мусор провинция назначить совет находить зеленый возникновение.', 'Даль табак металл мера.', 'Академик пропаганда подробность плод приличный упорно кидать.', 'При потянуться один фонарик.']
['Танцевать мотоцикл сходить.', 'Крыса смелый пропаганда точно социалистический даль настать.', 'Решение миг отметить рот пропасть.', 'Даль носок выбирать успокоиться назначить горький набор бок.', 'Покинуть забирать четыре мусор жидкий.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.sentences(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkl def def ghi def jkl.', 'Jkl def jkl abc abc.', 'Jkl ghi def jkl.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi abc ghi def ghi abc jkl jkl.']
['Ghi def jkl ghi.', 'Ghi jkl def.', 'Ghi abc jkl abc jkl abc.', 'Def abc def ghi jkl abc ghi.', 'Ghi jkl ghi jkl.']
['Ghi def abc jkl def abc abc jkl.', 'Ghi ghi def.', 'Ghi abc abc abc.', 'Jkl jkl ghi def.', 'Def jkl jkl jkl ghi jkl ghi.']
['Def ghi ghi jkl def def abc.', 'Ghi jkl abc ghi abc abc jkl def.', 'Abc abc ghi abc.', 'Ghi jkl ghi abc abc abc jkl.', 'Def def jkl abc.']
['Abc jkl ghi.', 'Abc jkl jkl abc def abc def.', 'Abc def def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Jkl abc ghi jkl def.']

text(max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → str¶

生成一个文本字符串。

The max_nb_chars argument controls the approximate number of characters the text string will have, and depending on its value, this method may use either words(), sentences(), or paragraphs() for text generation. The ext_word_list argument works in exactly the same way it would in any of those methods.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=20)
...
'Потом премьера.'
'Термин через.'
'Самостоятельно.'
'Исследование оборот.'
'Исполнять сустав.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=80)
...
'Бетонный второй настать расстройство наступать ложиться.'
'Июнь разуметься сверкать некоторый.'
'Жестокий издали механический покидать интеллектуальный народ набор видимо.'
'Засунуть командующий возникновение.'
'Правый господь карман зарплата изредка спорт домашний.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(max_nb_chars=160)
...
'Грустный полностью умирать набор командующий покинуть. Сынок некоторый функция ягода июнь разуметься. Хозяйка рай предоставить трубка табак.'
'Видимо прощение пространство бригада инструкция постоянный засунуть. Провинция неправда роскошный вздрогнуть посидеть спасть.'
'Подробность плод приличный упорно кидать проход пространство. Фонарик порт уточнить дошлый. Выкинуть бак рот столетие.'
'Решетка идея что спичка. Миллиард покидать советовать что.'
'Перебивать командующий господь парень добиться что. Металл стакан костер славный девка.'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.text(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'Abc jkl def jkl jkl jkl. Ghi jkl ghi def jkl ghi. Jkl ghi ghi ghi abc.\nJkl ghi def abc. Def ghi abc ghi def ghi.\nJkl abc jkl ghi jkl ghi ghi. Abc def jkl abc ghi abc.'
'Ghi def ghi def ghi def abc. Abc jkl def abc. Jkl jkl jkl jkl. Ghi jkl ghi ghi abc abc ghi.\nDef def ghi ghi jkl def def abc. Ghi jkl abc ghi abc abc jkl def. Abc abc ghi abc.'
'Ghi jkl abc abc def def. Ghi abc abc jkl. Def jkl def jkl ghi.\nJkl abc abc ghi. Ghi def abc def.\nJkl jkl ghi def ghi abc ghi. Ghi def abc def abc jkl def. Ghi ghi jkl jkl abc.'
'Def ghi abc def def abc ghi. Jkl ghi abc abc def jkl abc. Abc jkl ghi abc ghi jkl.\nDef abc ghi abc jkl ghi. Abc ghi abc def. Abc jkl def abc.\nJkl abc def ghi jkl ghi abc. Def abc abc ghi.'
'Def ghi abc abc. Def def ghi def def abc abc abc. Ghi def jkl def abc ghi def.\nAbc abc def abc def ghi. Jkl ghi def jkl. Abc abc ghi abc.\nDef ghi def def.'

texts(nb_texts: int = 3, max_nb_chars: int = 200, ext_word_list: Sequence[str] | None = None) → List[str]¶

生成一个文本字符串列表。

The nb_texts argument controls how many text strings the list will contain, and this method uses text() under the hood for text generation, so the two remaining arguments, max_nb_chars and ext_word_list will work in exactly the same way as well.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['Грустный полностью умирать набор командующий покинуть. Сынок некоторый функция ягода июнь разуметься. Хозяйка рай предоставить трубка табак.', 'Видимо прощение пространство бригада инструкция постоянный засунуть. Провинция неправда роскошный вздрогнуть посидеть спасть.', 'Угроза художественный миллиард ныне невозможно район упорно. Мучительно один блин коммунизм. Заведение райком провал прошептать. Витрина слать господь интеллектуальный дьявол космос столетие.', 'Подробность плод приличный упорно кидать проход пространство. Фонарик порт уточнить дошлый. Выкинуть бак рот столетие.', 'Решетка идея что спичка. Миллиард покидать советовать что.']
['Перебивать командующий господь парень добиться что. Металл стакан костер славный девка.', 'Чувство лететь пересечь монета товар спичка. Вздрогнуть угодный выбирать триста. Даль место дальний господь.', 'Печатать остановить некоторый опасность перебивать сутки. Мелочь рота жестокий угроза чем запустить угроза. Кольцо зачем возбуждение.', 'Приличный совет оборот фонарик степь команда. Набор анализ растеряться указанный. Соответствие инфекция перебивать рот.\nШкольный инвалид висеть космос.', 'А число наступать столетие заведение поставить валюта деньги. Равнодушный академик костер поговорить волк экзамен предоставить.']
['Лететь столетие роса. Написать да песня запустить одиннадцать горький неправда выгнать. Непривычный уничтожение потом порт мальчишка уронить.', 'Выражаться природа коричневый пересечь означать изучить хозяйка.\nЗасунуть пол пастух. Угол порт горький неожиданно деньги сутки коллектив. Кпсс выражение природа слишком засунуть.', 'Спорт беспомощный миф солнце. Госпожа теория очутиться. Ночь выражение мальчишка анализ медицина. Второй штаб ответить социалистический посидеть райком понятный.', 'Решение дурацкий запустить издали означать остановить. Да скрытый шлем изредка.\nСмеяться ответить сынок тревога. Изба наслаждение степь уточнить.', 'Головной пастух неожиданно порт возмутиться плод. Палата выражаться скользить цвет палата ученый.\nПроцесс металл спичка бегать экзамен уточнить. Падаль потянуться казнь пространство дошлый спорт.']
['Заработать поезд освободить посвятить миг угодный социалистический дыхание. Столетие умолять уничтожение умолять. Процесс порт зачем карандаш войти.', 'Крыса близко невыносимый поговорить уронить песня труп покидать. Терапия салон металл о цвет кольцо карандаш. Процесс витрина поезд космос очередной функция.', 'Желание грустный приходить равнодушный способ добиться. Передо лететь вздрогнуть результат пересечь.', 'Мучительно процесс роскошный аж витрина четыре.\nСтроительство голубчик виднеться дыхание свежий пятеро обида полевой. Редактор коллектив помимо правление через слишком солнце.', 'Солнце интеллектуальный вздрогнуть господь виднеться сынок. Сверкать передо миг появление ныне. Жидкий мелочь мера понятный плод зима банк.\nПосвятить зима проход господь ленинград заявление.']
['Бригада выражение задержать заработать академик. Счастье проход ложиться ленинград важный. Поезд пропадать увеличиваться желание одиннадцать.', 'Мимо академик конструкция заведение рассуждение отдел. Вперед запустить видимо оборот. Дьявол неожиданно уничтожение ныне угодный.', 'Пасть четко житель инструкция. Ход наслаждение легко да низкий коричневый.\nСынок светило вздрагивать лететь забирать. Изучить порт анализ заплакать мера горький устройство тута.', 'Плясать рай роса один предоставить избегать.\nКакой при монета кольцо. Пространство добиться достоинство коробка командующий отдел госпожа. Витрина горький тесно пересечь.', 'Сопровождаться очутиться степь. Слишком вообще покидать. Мелькнуть рабочий призыв темнеть разнообразный четко руководитель.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50)
...
['Покинуть успокоиться плясать поезд кольцо.', 'Сходить потрясти неправда карандаш.', 'Четко народ валюта находить сустав мгновение.', 'Помимо багровый магазин актриса.', 'Цель разводить единый. Столетие кузнец число миф.']
['Даль табак металл мера.', 'При потянуться один фонарик.', 'Решение миг отметить рот пропасть.', 'Покинуть забирать четыре мусор жидкий.', 'Уронить степь мера ягода кожа казнь пища.']
['Реклама девка похороны войти затянуться.', 'Покидать сутки головной. Порода народ сутки.', 'Хозяйка освобождение столетие чувство.', 'Проход коллектив способ труп посвятить.', 'Труп куча грустный разнообразный.']
['Мелочь рота жестокий угроза чем запустить угроза.', 'Сходить деловой приходить грустный светило один.', 'Ломать бровь передо.', 'Соответствие инфекция перебивать рот.', 'Через успокоиться народ коричневый.']
['Оборот дружно жестокий увеличиваться.', 'Носок а число наступать.', 'Поговорить волк экзамен предоставить да.', 'Приятель провал отъезд что число.', 'Зарплата солнце соответствие левый ход.']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5, max_nb_chars=50, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['Jkl def def ghi def jkl. Jkl def jkl abc abc.', 'Jkl def ghi jkl ghi def abc def.', 'Ghi def jkl ghi. Ghi jkl def.', 'Def abc def ghi jkl abc ghi. Ghi jkl ghi jkl.', 'Ghi ghi def. Ghi abc abc abc. Jkl jkl ghi def.']
['Def ghi ghi jkl def def abc.', 'Abc abc ghi abc. Ghi jkl ghi abc abc abc jkl.', 'Abc jkl ghi. Abc jkl jkl abc def abc def.', 'Abc jkl abc def ghi jkl jkl abc.', 'Abc jkl ghi abc ghi. Jkl jkl ghi def ghi abc ghi.']
['Ghi ghi jkl jkl abc. Def def ghi abc abc.', 'Def ghi def. Abc abc ghi.', 'Abc jkl jkl def ghi jkl jkl. Jkl def ghi def.', 'Abc ghi jkl def jkl. Def jkl ghi abc.', 'Def abc abc ghi. Def def ghi jkl jkl jkl ghi.']
['Abc def def. Ghi def ghi abc abc jkl.', 'Def jkl ghi. Def def def abc jkl.', 'Ghi jkl jkl ghi def jkl. Abc abc ghi abc.', 'Jkl ghi abc abc abc jkl ghi. Def def abc jkl.', 'Def def ghi jkl. Ghi abc def def jkl.']
['Jkl def jkl def def def. Ghi jkl abc ghi ghi.', 'Def ghi def jkl ghi jkl abc abc.', 'Jkl ghi jkl ghi ghi ghi jkl.', 'Ghi abc jkl abc jkl ghi. Ghi def abc jkl jkl.', 'Def jkl abc abc def. Jkl ghi abc ghi jkl def abc.']

word(part_of_speech: str | None = None, ext_word_list: Sequence[str] | None = None) → str¶

生成一个单词。

This method uses words() under the hood with the nb argument set to 1 to generate the result.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word()
...
'потом'
'премьера'
'выражение'
'термин'
'через'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.word(ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
'jkl'
'jkl'
'abc'
'ghi'
'jkl'

words(nb: int = 3, ext_word_list: List[str] | None = None, part_of_speech: str | None = None, unique: bool = False) → List[str]¶

生成一个单词元组。

nb 参数控制结果列表中的单词数量，如果提供了 ext_word_list，将使用该列表中的单词而不是区域提供者内置单词列表中的单词。

如果未提供 word_list，该方法将使用默认值 None，这将导致该方法调用 get_words_list 方法来获取单词列表。如果提供了 word_list，该方法将使用提供的列表。

If unique is True, this method will return a list containing unique words. Under the hood, random_sample() will be used for sampling without replacement. If unique is False, random_choices() is used instead, and the list returned may contain duplicates.

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words()
...
['мусор', 'бетонный', 'второй']
['настать', 'расстройство', 'наступать']
['ложиться', 'триста', 'единый']
['сынок', 'некоторый', 'функция']
['ягода', 'июнь', 'разуметься']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5)
...
['мусор', 'бетонный', 'второй', 'настать', 'расстройство']
['наступать', 'ложиться', 'триста', 'единый', 'сынок']
['некоторый', 'функция', 'ягода', 'июнь', 'разуметься']
['сверкать', 'некоторый', 'а', 'конструкция', 'рота']
['полюбить', 'передо', 'прошептать', 'витрина', 'висеть']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'])
...
['jkl', 'jkl', 'def', 'def', 'ghi']
['def', 'jkl', 'def', 'def', 'ghi']
['jkl', 'ghi', 'def', 'jkl', 'ghi']
['def', 'jkl', 'jkl', 'jkl', 'jkl']
['def', 'ghi', 'jkl', 'ghi', 'def']

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.words(nb=4, ext_word_list=['abc', 'def', 'ghi', 'jkl'], unique=True)
...
['jkl', 'def', 'abc', 'ghi']
['jkl', 'def', 'ghi', 'abc']
['ghi', 'jkl', 'abc', 'def']
['ghi', 'abc', 'jkl', 'def']
['def', 'jkl', 'abc', 'ghi']

`faker.providers.passport`¶

class faker.providers.passport.ru_RU.Provider(generator: Any)¶

Bases: Provider

passport_dob() → date¶

生成一个 datetime 出生日期。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.passport_dob()
...
datetime.date(2007, 11, 29)
datetime.date(1997, 11, 17)
datetime.date(1958, 9, 29)
datetime.date(1939, 12, 29)
datetime.date(1969, 4, 7)

passport_number() → str¶

通过替换令牌为字母数字来生成护照号码。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.passport_number()
...
'6048 764759'
'82 42 194892'
'1157 815659'
'87 78 408016'
'97 53 513933'

passport_owner(gender: Literal['M', 'F', 'X'] = 'M') → Tuple[str, str]¶

为护照持有人生成名字和姓氏。 gender 参数是护照持有人的性别标记，它是一个单字符字符串，可以是男性、女性或非二元性别。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.passport_owner()
...
('Сазонов', 'Никандр Федосеевич')
('Волков', 'Исидор Яковлевич')
('Мартынов', 'Онуфрий Ефимьевич')
('Меркушев', 'Самсон Ильясович')
('Логинов', 'Ерофей Юльевич')

`faker.providers.person`¶

class faker.providers.person.ru_RU.Provider(generator: Any)¶

Bases: Provider

first_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Никандр'
'Светлана'
'Пантелеймон'
'Андрон'
'Исидор'

first_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Мария'
'Наина'
'Алина'
'Иванна'
'Раиса'

first_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Никандр'
'Пантелеймон'
'Андрон'
'Исидор'
'Сократ'

first_name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Никандр'
'Светлана'
'Пантелеймон'
'Андрон'
'Исидор'

language_name() → str¶

生成一个随机的 i18n 语言名称（例如 English）。

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Самоанский'
'Таджикский'
'Аймарский'
'Литовский'
'Идиш'

last_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Кулакова'
'Мамонтов'
'Потапова'
'Брагина'
'Одинцов'

last_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Сазонова'
'Блинова'
'Мишина'
'Белозерова'
'Гаврилова'

last_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Сазонов'
'Блинов'
'Мишин'
'Белозеров'
'Гаврилов'

last_name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Кулакова'
'Мамонтов'
'Потапова'
'Брагина'
'Одинцов'

middle_name() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.middle_name()
...
'Теймуразович'
'Романовна'
'Федосеевич'
'Анатольевич'
'Дорофеевич'

middle_name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.middle_name_female()
...
'Натановна'
'Николаевна'
'Аскольдовна'
'Захаровна'
'Степановна'

middle_name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.middle_name_male()
...
'Теймуразович'
'Федосеевич'
'Анатольевич'
'Дорофеевич'
'Яковлевич'

name() → str¶

示例:: ‘John Doe’
示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Наина Аскольдовна Осипова'
'Пелагея Ниловна Русакова'
'Клавдия Романовна Ефимова'
'Бурова Екатерина Сергеевна'
'Кудрявцев Валентин Димитриевич'

name_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Наина Аскольдовна Осипова'
'Пелагея Ниловна Русакова'
'Клавдия Романовна Ефимова'
'Екатерина Сергеевна Кудрявцева'
'Симонова Антонина Яковлевна'

name_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Пантелеймон Анатольевич Осипов'
'Святослав Трофимович Русаков'
'Лазарь Харлампович Ефимов'
'Ерофей Юльевич Кудрявцев'
'Симонов Валентин Димитриевич'

name_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Наина Аскольдовна Осипова'
'Пелагея Ниловна Русакова'
'Клавдия Романовна Ефимова'
'Бурова Екатерина Сергеевна'
'Кудрявцев Валентин Димитриевич'

prefix() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'тов.'
'тов.'
'тов.'
'тов.'
'г-жа'

prefix_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'тов.'
'тов.'
'г-жа'
'тов.'
'тов.'

prefix_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'тов.'
'тов.'
'г-н'
'тов.'
'тов.'

prefix_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'тов.'
'тов.'
'тов.'
'тов.'
'г-жа'

suffix() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix()
...
''
''
''
''
''

suffix_female() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_female()
...
''
''
''
''
''

suffix_male() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_male()
...
''
''
''
''
''

suffix_nonbinary() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.suffix_nonbinary()
...
''
''
''
''
''

`faker.providers.phone_number`¶

class faker.providers.phone_number.ru_RU.Provider(generator: Any)¶

基类: Provider

country_calling_code() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country_calling_code()
...
'+687'
'+595'
'+880'
'+964'
'+41'

msisdn() → str¶

https://en.wikipedia.org/wiki/MSISDN

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.msisdn()
...
'6048764759382'
'2194892411578'
'5659387784080'
'6097535139332'
'1158714841858'

phone_number() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'8 604 876 47 59'
'+7 (824) 219-4892'
'+71157815659'
'+7 (877) 840-8016'
'+7 975 351 3933'

`faker.providers.ssn`¶

class faker.providers.ssn.ru_RU.Provider(generator: Any)¶

Bases: Provider

ssn() → str¶

示例:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'604876475938'
'421948924115'
'815659387784'
'801609753513'
'328711587148'

Locale ru_RU¶

`faker.providers.address`¶

`faker.providers.automotive`¶

`faker.providers.bank`¶

`faker.providers.color`¶

`faker.providers.company`¶

`faker.providers.credit_card`¶

`faker.providers.currency`¶

`faker.providers.date_time`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.lorem`¶

`faker.providers.passport`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶

目录

上一主题

下一主题

本页

Locale ru_RU¶

faker.providers.address¶

faker.providers.automotive¶

faker.providers.bank¶

faker.providers.color¶

faker.providers.company¶

faker.providers.credit_card¶

faker.providers.currency¶

faker.providers.date_time¶

faker.providers.internet¶

faker.providers.job¶

faker.providers.lorem¶

faker.providers.passport¶

faker.providers.person¶

faker.providers.phone_number¶

faker.providers.ssn¶

`faker.providers.address`¶

`faker.providers.automotive`¶

`faker.providers.bank`¶

`faker.providers.color`¶

`faker.providers.company`¶

`faker.providers.credit_card`¶

`faker.providers.currency`¶

`faker.providers.date_time`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.lorem`¶

`faker.providers.passport`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶