Locale mk_MK¶

`faker.providers.address`¶

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

Bases: Provider

Address provider for mk_MK locale (Macedonian).

Sources: - https://en.wikipedia.org/wiki/List_of_cities_in_North_Macedonia - https://en.wikipedia.org/wiki/List_of_sovereign_states

address() → str¶

Example:: ‘791 Crist Parks, Sashabury, IL 86039-9874’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'Кеј Македонија 8б\n64759 Тетово'
'Благој Давков 94\n41157 Охрид'
'Самоилова 7б/8\n08016 Струмица'
'Никола Русински 39\n32871 Македонски Брод'
'Јован Хаџи Константинов Џинот 1б\n83989 Свети Николе'

administrative_unit() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.administrative_unit()
...
'Југозападен'
'Југозападен'
'Скопски'
'Источен'
'Североисточен'

building_number() → str¶

Example:: ‘791’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.building_number()
...
'6а/0'
'8б'
'6б/4'
'5б/9'
'8а'

city() → str¶

Example:: ‘Sashabury’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Радовиш'
'Крива Паланка'
'Пробиштип'
'Струга'
'Кичево'

city_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_name()
...
'Прилеп'
'Радовиш'
'Богданци'
'Крива Паланка'
'Тетово'

city_suffix() → str¶

Example:: ‘town’
Examples:

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

country() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.country()
...
'Лесото'
'Зимбабве'
'Малдиви'
'Ерменија'
'Гана'

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

Examples:

>>> 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¶

Examples:

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

current_country_code() → str¶

Examples:

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

postcode() → str¶

Example:: 86039-9874
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'60487'
'47593'
'42194'
'41157'
'56593'

state() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Југозападен'
'Југозападен'
'Скопски'
'Источен'
'Североисточен'

street_address() → str¶

Example:: ‘791 Crist Parks’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Лондонска 487'
'Јован Хаџи Константинов Џинот 5б/9'
'Востаничка 4'
'Јане Сандански 8б'
'Кирил Пејчиновиќ 15'

street_name() → str¶

Example:: ‘Crist Parks’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Софиска'
'Лондонска'
'Кеј Македонија'
'Георги Димитров'
'Одбранбена'

street_suffix() → str¶

Example:: ‘Avenue’
Examples:

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

`faker.providers.automotive`¶

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

Bases: Provider

Automotive provider for mk_MK locale (Macedonian).

Sources: - https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_North_Macedonia

Standard format: XX NNNN YY where XX = two-letter regional code, NNNN = 4-digit number, YY = two letters

Notes: - Letters Q, W, X, Y are NOT used (no Cyrillic equivalents). - Country identifier changed from MK to NMK in February 2019 (Prespa Agreement).

license_plate() → str¶

Generate a license plate.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.license_plate()
...
'SK 6048 PM'
'PE 7593 RE'
'OH 2194 SU'
'KI 4115 PS'
'GE 5659 VG'

vin() → str¶

Generate vin number.

Examples:

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

`faker.providers.bank`¶

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

Bases: Provider

Bank provider for mk_MK locale (Macedonian).

Sources: - https://en.wikipedia.org/wiki/IBAN#IBAN_formats_by_country

MK IBAN: MK + 2 check digits + 3-digit bank code + 10-digit account + 2 national check digits Total BBAN length: 15 digits/chars (3 bank + 10 account + 2 check)

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

aba() → str¶

Generate an ABA routing transit number.

Examples:

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

bank() → str¶

Generate a bank name.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bank()
...
'ТТК банка'
'Развојна банка на Северна Македонија'
'Универзална инвестициона банка'
'Развојна банка на Северна Македонија'
'Народна банка на Република Северна Македонија'

bank_country() → str¶

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

Examples:

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

bban() → str¶

Generate a Basic Bank Account Number (BBAN).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bban()
...
'938MYNBIQPMZJPL24'
'115EYDTZIRWZTEJ78'
'080DLNKTUGRPOQI16'
'139WZVUATPKHXKW33'
'841ZEZROCCKQPDJ85'

iban() → str¶

Generate an International Bank Account Number (IBAN).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'MK75938MYNBIQPMZJPL24'
'MK07115EYDTZIRWZTEJ78'
'MK06080DLNKTUGRPOQI16'
'MK78139WZVUATPKHXKW33'
'MK12841ZEZROCCKQPDJ85'

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift()
...
'YNBIMK65ZT4'
'SGQEMKSIGQ8'
'JDXCMKV4'
'LNKTMKN9'
'OQIBMK9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8)
...
'MYNBMKQ6'
'PMZJMK4W'
'SGQEMKSI'
'YDTZMKQ8'
'WZTEMKTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=8, use_dataset=True)
...
'MYNBMKQ6'
'PMZJMK4W'
'SGQEMKSI'
'YDTZMKQ8'
'WZTEMKTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11)
...
'MYNBMKQ65ZT'
'PLSGMK6ISIG'
'TZIRMKJTGEV'
'PRDLMK1UN94'
'OQIBMK9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True)
...
'MYNBMKQ6XXX'
'PMZJMK4WXXX'
'SGQEMKSIXXX'
'YDTZMKQ8XXX'
'WZTEMKTGXXX'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, use_dataset=True)
...
'MYNBMKQ65ZT'
'PLSGMK6ISIG'
'TZIRMKJTGEV'
'PRDLMK1UN94'
'OQIBMK9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift(length=11, primary=True, use_dataset=True)
...
'MYNBMKQ6XXX'
'PMZJMK4WXXX'
'SGQEMKSIXXX'
'YDTZMKQ8XXX'
'WZTEMKTGXXX'

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11()
...
'MYNBMKQ65ZT'
'PLSGMK6ISIG'
'TZIRMKJTGEV'
'PRDLMK1UN94'
'OQIBMK9AFZA'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift11(use_dataset=True)
...
'MYNBMKQ65ZT'
'PLSGMK6ISIG'
'TZIRMKJTGEV'
'PRDLMK1UN94'
'OQIBMK9AFZA'

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8()
...
'MYNBMKQ6'
'PMZJMK4W'
'SGQEMKSI'
'YDTZMKQ8'
'WZTEMKTG'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.swift8(use_dataset=True)
...
'MYNBMKQ6'
'PMZJMK4W'
'SGQEMKSI'
'YDTZMKQ8'
'WZTEMKTG'

`faker.providers.color`¶

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

Bases: Provider

Color provider for mk_MK locale (Macedonian).

Sources: - https://mk.wikipedia.org/wiki/Боја (spectrum colors with hex codes) - Standard Macedonian color terminology with CSS/web hex values

Generate a color in a human-friendly way.

Under the hood, this method first creates a color represented in the HSV color model and then converts it to the desired color_format. The argument hue controls the H value according to the following rules:

If the value is a number from 0 to 360, it will serve as the H value of the generated color.
If the value is a tuple/list of 2 numbers from 0 to 360, the color’s H value will be randomly selected from that range.
If the value is a valid string, the color’s H value will be randomly selected from the H range corresponding to the supplied string. Valid values are 'monochrome', 'red', 'orange', 'yellow', 'green', 'blue', 'purple', and 'pink'.

The argument luminosity influences both S and V values and is partially affected by hue as well. The finer details of this relationship are somewhat involved, so please refer to the source code instead if you wish to dig deeper. To keep the interface simple, this argument either can be omitted or can accept the following string values:'bright', 'dark', 'light', or 'random'.

The argument color_format controls in which color model the color is represented. Valid values are 'hsv', 'hsl', 'rgb', or 'hex' (default).

Examples:

>>> 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)'

Generate a HSL color tuple.

Examples:

>>> 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)

Generate a HSV color tuple.

Examples:

>>> 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¶

Generate a color name.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'Бронзена'
'Лавандула'
'Жолта'
'Темносина'
'Бордо'

Generate a RGB color tuple of integers.

Examples:

>>> 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)

Generate a RGB color tuple of floats.

Examples:

>>> 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¶

Generate a color formatted as a hex triplet.

Examples:

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

rgb_color() → str¶

Generate a color formatted as a comma-separated RGB value.

Examples:

>>> 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¶

Generate a color formatted as a CSS rgb() function.

Examples:

>>> 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¶

Generate a web-safe color name.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_color_name()
...
'сина'
'сина'
'црна'
'виолетова'
'сива'

safe_hex_color() → str¶

Generate a web-safe color formatted as a hex triplet.

Examples:

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

`faker.providers.company`¶

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

Bases: Provider

Company provider for mk_MK locale (Macedonian).

bs() → str¶

Example:: ‘integrate extensible convergence’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'iterate integrated e-markets'
'integrate back-end mindshare'
'synthesize wireless content'
'syndicate synergistic applications'
'productize killer mindshare'

catch_phrase() → str¶

Example:: ‘Robust full-range hub’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'Networked well-modulated instruction set'
'Balanced empowering migration'
'Pre-emptive impactful toolset'
'Innovative mission-critical help-desk'
'Reduced didactic middleware'

company() → str¶

Example:: ‘Acme Ltd’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Матевска и Стојановска ЈП'
'Лазов ООД'
'Цветковска и Младеновска КД'
'Пановски и Ѓорѓиевска ЕД'
'Матевски Димитриев ДОО'

company_suffix() → str¶

Example:: ‘Ltd’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_suffix()
...
'ЈП'
'ЈП'
'АД'
'КД'
'ООД'

`faker.providers.currency`¶

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

Bases: Provider

Currency provider for mk_MK locale (Macedonian).

Sources: - https://mk.wikipedia.org/wiki/Валута - https://en.wikipedia.org/wiki/List_of_circulating_currencies

cryptocurrency() → Tuple[str, str]¶

Examples:

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

cryptocurrency_code() → str¶

Examples:

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

cryptocurrency_name() → str¶

Examples:

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

currency() → Tuple[str, str]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency()
...
('PHP', 'Филипинско пезо')
('SAR', 'Саудиски ријал')
('BAM', 'Конвертибилна марка на БиХ')
('KHR', 'Камбоџански риел')
('UZS', 'Узбекистански сум')

currency_code() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_code()
...
'PHP'
'SAR'
'BAM'
'KHR'
'UZS'

currency_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_name()
...
'Филипинско пезо'
'Саудиски ријал'
'Конвертибилна марка на БиХ'
'Камбоџански риел'
'Узбекистански сум'

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

Example:: $
Examples:

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

pricetag() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pricetag()
...
'6.048 ден.'
'6.475 ден.'
'38.242 ден.'
'9 ден.'
'892 ден.'

`faker.providers.date_time`¶

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

Bases: Provider

Date/time provider for mk_MK locale (Macedonian).

am_pm() → str¶

Examples:

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

century() → str¶

Examples:

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

Get a date string between January 1, 1970 and now.

Parameters:

pattern – Format of the date (year-month-day by default)
end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2017-09-15'
'2012-10-27'
'1993-10-05'
'1984-08-17'
'1998-11-20'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(pattern='%m/%d/%Y')
...
'09/15/2017'
'10/27/2012'
'10/05/1993'
'08/17/1984'
'11/20/1998'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date(end_datetime='+1w')
...
'2017-09-21'
'2012-11-01'
'1993-10-08'
'1984-08-19'
'1998-11-23'

Get a Date object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

Parameters:

start_date – A DateParseType. Defaults to 30 years ago
end_date – A DateParseType. Defaults to "today"

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 10, 29)
datetime.date(2019, 3, 26)
datetime.date(2009, 2, 9)
datetime.date(2004, 4, 5)
datetime.date(2011, 10, 31)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1w')
...
datetime.date(2026, 6, 28)
datetime.date(2026, 6, 28)
datetime.date(2026, 6, 25)
datetime.date(2026, 6, 24)
datetime.date(2026, 6, 26)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date="-1y", end_date="+1w")
...
datetime.date(2026, 5, 9)
datetime.date(2026, 4, 7)
datetime.date(2025, 12, 2)
datetime.date(2025, 10, 3)
datetime.date(2026, 1, 5)

Get a random date between the two given dates.

Parameters:

date_start – A DateParseType. Defaults to the UNIX epoch
date_end – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)

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

Get a date object between January 1, 1970 and now

Parameters:: end_datetime – A DateParseType. Defaults to the current date and time
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2017, 9, 15)
datetime.date(2012, 10, 27)
datetime.date(1993, 10, 5)
datetime.date(1984, 8, 17)
datetime.date(1998, 11, 20)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object(end_datetime='+1w')
...
datetime.date(2017, 9, 21)
datetime.date(2012, 11, 1)
datetime.date(1993, 10, 8)
datetime.date(1984, 8, 19)
datetime.date(1998, 11, 23)

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

Generate a random date of birth represented as a Date object, constrained by optional miminimum_age and maximum_age parameters.

Parameters:

tzinfo – Defaults to None.
minimum_age – Defaults to 0.
maximum_age – Defaults to 115.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2008, 6, 12)
datetime.date(1998, 6, 1)
datetime.date(1959, 4, 13)
datetime.date(1940, 7, 12)
datetime.date(1969, 10, 20)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth(minimum_age=30, maximum_age=50)
...
datetime.date(1993, 3, 24)
datetime.date(1991, 5, 31)
datetime.date(1984, 4, 29)
datetime.date(1980, 12, 6)
datetime.date(1986, 3, 25)

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

Gets a Date object for the current century.

Parameters:

before_today – include days in current century before today. Defaults to True
after_today – include days in current century after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2022, 5, 16)
datetime.date(2020, 1, 30)
datetime.date(2011, 2, 21)
datetime.date(2006, 11, 10)
datetime.date(2013, 7, 18)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century(before_today=False, after_today=True)
...
datetime.date(2088, 7, 25)
datetime.date(2082, 3, 17)
datetime.date(2057, 5, 29)
datetime.date(2045, 7, 11)
datetime.date(2064, 1, 28)

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

Gets a Date object for the decade year.

Parameters:

before_today – include days in current decade before today. Defaults to True
after_today – include days in current decade after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2025, 6, 25)
datetime.date(2024, 12, 2)
datetime.date(2022, 9, 24)
datetime.date(2021, 9, 6)
datetime.date(2023, 4, 27)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade(before_today=False, after_today=True)
...
datetime.date(2029, 6, 15)
datetime.date(2029, 2, 24)
datetime.date(2027, 12, 20)
datetime.date(2027, 5, 27)
datetime.date(2028, 4, 14)

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

Gets a Date object for the current month.

Parameters:

before_today – include days in current month before today. Defaults to True
after_today – include days in current month after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2026, 6, 25)
datetime.date(2026, 6, 22)
datetime.date(2026, 6, 13)
datetime.date(2026, 6, 8)
datetime.date(2026, 6, 15)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month(before_today=False, after_today=True)
...
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)
datetime.date(2026, 6, 30)

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

Gets a Date object for the current year.

Parameters:

before_today – include days in current year before today. Defaults to True
after_today – include days in current year after today. Defaults to False

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2026, 6, 1)
datetime.date(2026, 5, 17)
datetime.date(2026, 3, 17)
datetime.date(2026, 2, 16)
datetime.date(2026, 4, 3)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year(before_today=False, after_today=True)
...
datetime.date(2026, 12, 3)
datetime.date(2026, 11, 17)
datetime.date(2026, 9, 15)
datetime.date(2026, 8, 16)
datetime.date(2026, 10, 2)

Get a datetime object for a date between January 1, 1970 and a specified end_datetime

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass
end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 9, 15, 9, 32, 42, 779885)
datetime.datetime(2012, 10, 27, 4, 0, 48, 461000)
datetime.datetime(1993, 10, 5, 8, 54, 53, 789981)
datetime.datetime(1984, 8, 17, 16, 6, 44, 571865)
datetime.datetime(1998, 11, 20, 0, 6, 3, 677870)

Get a datetime object for a date between January 1, 0001 and now

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass
end_datetime – A DateParseType. Defaults to the current date and time
start_datetime – A DateParseType. Defaults to UNIX timestamp -62135596800,

equivalent to 0001-01-01 00:00:00 UTC

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1711, 5, 17, 12, 7, 38, 249741)
datetime.datetime(1536, 3, 27, 4, 7, 2, 344368)
datetime.datetime(852, 11, 12, 11, 17, 45, 833977)
datetime.datetime(525, 6, 8, 18, 13, 25, 541718)
datetime.datetime(1036, 8, 2, 8, 31, 44, 670074)

Get a datetime object based on a random date between two given dates. Accepts date strings that can be recognized by strtotime().

Parameters:

start_date – A DateParseType. Defaults to 30 years ago
end_date – A DateParseType. Defaults to "now"
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 10, 30, 0, 9, 11, 236214)
datetime.datetime(2019, 3, 27, 13, 33, 57, 808743)
datetime.datetime(2009, 2, 10, 19, 3, 38, 361449)
datetime.datetime(2004, 4, 6, 12, 14, 14, 49189)
datetime.datetime(2011, 11, 1, 15, 31, 10, 171082)

Get a random datetime between the two given datetimes.

Parameters:

datetime_start – A DateParseType. Defaults to the UNIX epoch
datetime_end – A DateParseType. Defaults to the current date and time
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2026, 6, 30, 16, 58, 28)
datetime.datetime(2026, 6, 30, 16, 58, 28)
datetime.datetime(2026, 6, 30, 16, 58, 28)
datetime.datetime(2026, 6, 30, 16, 58, 28)
datetime.datetime(2026, 6, 30, 16, 58, 28)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2021, 10, 30, 0, 9, 11, 236214)
datetime.datetime(2019, 3, 27, 13, 33, 57, 808743)
datetime.datetime(2009, 2, 10, 19, 3, 38, 361449)
datetime.datetime(2004, 4, 6, 12, 14, 14, 49189)
datetime.datetime(2011, 11, 1, 15, 31, 10, 171082)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
...
datetime.datetime(2027, 5, 5, 2, 58, 25, 441207)
datetime.datetime(2027, 4, 3, 13, 1, 14, 993625)
datetime.datetime(2026, 12, 1, 7, 36, 14, 345382)
datetime.datetime(2026, 10, 3, 6, 34, 35, 534973)
datetime.datetime(2027, 1, 3, 10, 41, 9, 405703)

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

Gets a datetime object for the current century.

Parameters:

before_now – include days in current century before today. Defaults to True
after_now – include days in current century after today. Defaults to False
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2022, 5, 17, 1, 37, 11, 153265)
datetime.datetime(2020, 1, 31, 6, 15, 36, 104341)
datetime.datetime(2011, 2, 22, 4, 2, 50, 905449)
datetime.datetime(2006, 11, 10, 17, 17, 32, 604121)
datetime.datetime(2013, 7, 18, 23, 12, 36, 333973)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century(before_now=False, after_now=True)
...
datetime.datetime(2088, 7, 25, 3, 32, 59, 15421)
datetime.datetime(2082, 3, 17, 17, 32, 38, 518548)
datetime.datetime(2057, 5, 29, 21, 58, 29, 17299)
datetime.datetime(2045, 7, 11, 22, 6, 19, 300401)
datetime.datetime(2064, 1, 29, 1, 11, 6, 372227)

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

Gets a datetime object for the decade year.

Parameters:

before_now – include days in current decade before today. Defaults to True
after_now – include days in current decade after today. Defaults to False
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2025, 6, 26, 13, 34, 50, 719527)
datetime.datetime(2024, 12, 3, 9, 41, 38, 779763)
datetime.datetime(2022, 9, 24, 21, 26, 16, 520900)
datetime.datetime(2021, 9, 6, 8, 0, 27, 823217)
datetime.datetime(2023, 4, 28, 2, 31, 33, 392733)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade(before_now=False, after_now=True)
...
datetime.datetime(2029, 6, 15, 19, 32, 46, 521327)
datetime.datetime(2029, 2, 25, 2, 39, 31, 512733)
datetime.datetime(2027, 12, 21, 3, 53, 17, 363667)
datetime.datetime(2027, 5, 28, 4, 42, 57, 770848)
datetime.datetime(2028, 4, 15, 6, 55, 33, 145850)

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

Gets a datetime object for the current month.

Parameters:

before_now – include days in current month before today. Defaults to True
after_now – include days in current month after today. Defaults to False
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2026, 6, 26, 2, 3, 4, 321684)
datetime.datetime(2026, 6, 23, 12, 24, 7, 629662)
datetime.datetime(2026, 6, 13, 11, 51, 24, 441091)
datetime.datetime(2026, 6, 8, 16, 36, 3, 694311)
datetime.datetime(2026, 6, 16, 4, 31, 32, 917535)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2026, 6, 30, 22, 54, 25, 117469)
datetime.datetime(2026, 6, 30, 22, 17, 58, 182759)
datetime.datetime(2026, 6, 30, 19, 55, 45, 96422)
datetime.datetime(2026, 6, 30, 18, 47, 36, 522448)
datetime.datetime(2026, 6, 30, 20, 33, 59, 160253)

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

Gets a datetime object for the current year.

Parameters:

before_now – include days in current year before today. Defaults to True
after_now – include days in current year after today. Defaults to False
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2026, 6, 2, 14, 14, 9, 565421)
datetime.datetime(2026, 5, 17, 23, 13, 43, 952183)
datetime.datetime(2026, 3, 18, 0, 0, 29, 513243)
datetime.datetime(2026, 2, 16, 18, 54, 55, 185333)
datetime.datetime(2026, 4, 3, 9, 23, 7, 442398)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2026, 12, 3, 7, 52, 25, 944273)
datetime.datetime(2026, 11, 17, 9, 25, 34, 98943)
datetime.datetime(2026, 9, 16, 5, 10, 23, 859839)
datetime.datetime(2026, 8, 17, 10, 10, 11, 451906)
datetime.datetime(2026, 10, 2, 22, 21, 20, 170682)

day_of_month() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'15'
'27'
'05'
'17'
'20'

day_of_week() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'Сабота'
'Недела'
'Среда'
'Сабота'
'Сабота'

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

Get a Date object based on a random date between 1 day from now and a given date.

Parameters:

end_date – A DateParseType. Defaults to "+30d"
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2026, 7, 25)
datetime.date(2026, 7, 22)
datetime.date(2026, 7, 13)
datetime.date(2026, 7, 8)
datetime.date(2026, 7, 15)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date(end_date='+1y')
...
datetime.date(2027, 5, 4)
datetime.date(2027, 4, 2)
datetime.date(2026, 12, 1)
datetime.date(2026, 10, 3)
datetime.date(2027, 1, 3)

Get a datetime object based on a random date between 1 second form now and a given date.

Parameters:

end_date – A DateParseType. Defaults to "+30d"
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2026, 7, 26, 0, 57, 29, 594731)
datetime.datetime(2026, 7, 23, 10, 42, 6, 54467)
datetime.datetime(2026, 7, 13, 7, 47, 10, 116942)
datetime.datetime(2026, 7, 8, 11, 23, 40, 957843)
datetime.datetime(2026, 7, 16, 1, 5, 32, 566513)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2027, 5, 5, 2, 58, 25, 596785)
datetime.datetime(2027, 4, 3, 13, 1, 15, 235670)
datetime.datetime(2026, 12, 1, 7, 36, 14, 924810)
datetime.datetime(2026, 10, 3, 6, 34, 36, 276056)
datetime.datetime(2027, 1, 3, 10, 41, 9, 894428)

Get an ISO 8601 string for a datetime between the UNIX epoch and now.

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass
end_datetime – A DateParseType. Defaults to the current date and time
sep – separator between date and time, defaults to ‘T’
timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2017-09-15T09:32:42.779885'
'2012-10-27T04:00:48.461000'
'1993-10-05T08:54:53.789981'
'1984-08-17T16:06:44.571865'
'1998-11-20T00:06:03.677870'

month() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'09'
'10'
'10'
'08'
'11'

month_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'Септември'
'Октомври'
'Октомври'
'Август'
'Ноември'

Get a Date object based on a random date between a given date and 1 day ago.

Parameters:

start_date – A DateParseType. Defaults to "-30d"
tzinfo – timezone, instance of datetime.tzinfo subclass

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2026, 6, 24)
datetime.date(2026, 6, 21)
datetime.date(2026, 6, 12)
datetime.date(2026, 6, 7)
datetime.date(2026, 6, 14)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date(start_date='-1y')
...
datetime.date(2026, 5, 3)
datetime.date(2026, 4, 1)
datetime.date(2025, 11, 29)
datetime.date(2025, 10, 1)
datetime.date(2026, 1, 1)

Get a datetime object based on a random date between a given date and 1 second ago.

Parameters:

start_date – A DateParseType. Defaults to "-30d"
tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2026, 6, 26, 0, 57, 28, 594731)
datetime.datetime(2026, 6, 23, 10, 42, 5, 54467)
datetime.datetime(2026, 6, 13, 7, 47, 9, 116942)
datetime.datetime(2026, 6, 8, 11, 23, 39, 957843)
datetime.datetime(2026, 6, 16, 1, 5, 31, 566513)

pytimezone(*args: Any, **kwargs: Any) → tzinfo | None¶

Generate a random timezone (see faker.timezone for any args) and return a Python object usable as a tzinfo for datetime or other fakers.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
zoneinfo.ZoneInfo(key='Indian/Maldives')
zoneinfo.ZoneInfo(key='America/Barbados')
zoneinfo.ZoneInfo(key='Europe/Stockholm')
zoneinfo.ZoneInfo(key='Africa/Windhoek')
zoneinfo.ZoneInfo(key='Asia/Qatar')

Get a time string (24h format by default)

Parameters:

pattern – format
end_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'09:32:42'
'04:00:48'
'08:54:53'
'16:06:44'
'00:06:03'

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'09:32 AM'
'04:00 AM'
'08:54 AM'
'04:06 PM'
'12:06 AM'

Get a random timedelta object of duration between the current date and time and end_datetime

Parameters:: end_datetime – A DateParseType. Defaults to the current date and time
Examples:

>>> 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)

Get a time object

Parameters:: end_datetime – A DateParseType. Defaults to the current date and time
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(9, 32, 42, 779885)
datetime.time(4, 0, 48, 461000)
datetime.time(8, 54, 53, 789981)
datetime.time(16, 6, 44, 571865)
datetime.time(0, 6, 3, 677870)

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(10, 23, 22, 698550)
datetime.time(4, 46, 17, 96851)
datetime.time(9, 20, 7, 847672)
datetime.time(16, 22, 16, 672166)
datetime.time(0, 36, 44, 266867)

Returns a generator yielding tuples of (<datetime>, <value>).

The data points will start at start_date, and be at every time interval specified by precision.

Parameters:

start_date – A DateParseType. Defaults to "-30d"
end_date – A DateParseType. Defaults to "now"
precision – A float representing the time interval between data points.

Defaults to 1/30th of the time :param distrib: A callable that accepts a datetime object and returns a value. Defaults to a uniform distribution :param tzinfo: timezone, instance of datetime.tzinfo subclass

Examples:

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

timezone() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Indian/Maldives'
'America/Barbados'
'Europe/Stockholm'
'Africa/Windhoek'
'Asia/Qatar'

Get a timestamp between January 1, 1970 and now, unless passed explicit start_datetime or end_datetime values.

On Windows, the decimal part is always 0.

Parameters:

end_datetime – A DateParseType. Defaults to the UNIX epoch
start_datetime – A DateParseType. Defaults to the current date and time

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1505467962.7798846
1351310448.4610002
749811293.7899812
461606804.5718654
911520363.67787

year() → str¶

Examples:

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

`faker.providers.geo`¶

class faker.providers.geo.mk_MK.Provider(generator: Any)¶

Bases: Provider

Geo provider for mk_MK locale (Macedonian).

Sources: - https://en.wikipedia.org/wiki/Geography_of_North_Macedonia

Bounding box: lat 40.85°N – 42.37°N, lon 20.45°E – 23.03°E Center (Skopje): lat 41.9981°N, lon 21.4254°E

coordinate(center: float | None = None, radius: float | int = 0.001) → Decimal¶

Optionally center the coord and pick a point within radius.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.coordinate()
...
Decimal('26.826999')
Decimal('45.792650')
Decimal('-158.265114')
Decimal('-40.995129')
Decimal('94.488524')

latitude() → Decimal¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latitude()
...
Decimal('13.4134995')
Decimal('22.896325')
Decimal('-79.132557')
Decimal('-20.4975645')
Decimal('47.244262')

latlng() → Tuple[Decimal, Decimal]¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latlng()
...
(Decimal('13.4134995'), Decimal('45.792650'))
(Decimal('-79.132557'), Decimal('-40.995129'))
(Decimal('47.244262'), Decimal('80.880444'))
(Decimal('18.6986795'), Decimal('-17.160223'))
(Decimal('37.935520'), Decimal('12.226293'))

local_latitude() → Decimal¶

Return a latitude within North Macedonia’s bounding box.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.local_latitude()
...
Decimal('42.116633')
Decimal('41.986932')
Decimal('41.480857')
Decimal('41.238375')
Decimal('41.616912')

local_latlng(country_code: str = 'US', coords_only: bool = False) → Tuple[str, ...] | None¶

Returns a location known to exist on land in a country specified by country_code. Defaults to ‘en_US’. See the land_coords list for available locations/countries.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.local_latlng()
...
('40.72371', '-73.95097', 'Greenpoint', 'US', 'America/New_York')
('41.48199', '-81.79819', 'Lakewood', 'US', 'America/New_York')
('30.17746', '-81.38758', 'Palm Valley', 'US', 'America/New_York')
('41.72059', '-87.70172', 'Evergreen Park', 'US', 'America/Chicago')
('33.93113', '-117.54866', 'Norco', 'US', 'America/Los_Angeles')

local_longitude() → Decimal¶

Return a longitude within North Macedonia’s bounding box.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.local_longitude()
...
Decimal('22.628608')
Decimal('22.405522')
Decimal('21.535075')
Decimal('21.118005')
Decimal('21.769089')

location_on_land(coords_only: bool = False) → Tuple[str, ...]¶

Returns a random tuple specifying a coordinate set guaranteed to exist on land. Format is (latitude, longitude, place name, two-letter country code, timezone) Pass coords_only to return coordinates without metadata.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.location_on_land()
...
('40.56754', '-89.64066', 'Pekin', 'US', 'America/Chicago')
('25.13915', '73.06784', 'Sheoganj', 'IN', 'Asia/Kolkata')
('-7.60361', '37.00438', 'Kidodi', 'TZ', 'Africa/Dar_es_Salaam')
('33.35283', '-111.78903', 'Gilbert', 'US', 'America/Phoenix')
('17.54907', '82.85749', 'Elamanchili', 'IN', 'Asia/Kolkata')

longitude() → Decimal¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.longitude()
...
Decimal('26.826999')
Decimal('45.792650')
Decimal('-158.265114')
Decimal('-40.995129')
Decimal('94.488524')

`faker.providers.internet`¶

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

Bases: Provider

Internet provider for mk_MK locale (Macedonian).

ascii_company_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'ognen2012@bojadzhiev.org'
'nina1987@panovski.edu'
'dimovskidaniel@dimovska.edu'
'mnikolovska@mladenovski.com.mk'
'enaumovski@panovski.net'

ascii_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'sonja1993@atanasova.org'
'nina1987@panovski.edu'
'vasilkasimonovska@yahoo.com'
'jasmina92@gjorgiev.gov.mk'
'elizabeta1988@mail.mk'

ascii_free_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'ognen2012@neotel.mk'
'deshanovskamartina@alfa.mk'
'kuzmankrstev@telekom.mk'
'sofija38@hotmail.com'
'vasilkasimonovska@yahoo.com'

ascii_safe_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'ognen2012@example.com'
'deshanovskamartina@example.com'
'kuzmankrstev@example.com'
'sofija38@example.org'
'vasilkasimonovska@example.org'

company_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'ognen2012@bojadzhiev.org'
'nina1987@panovski.edu'
'dimovskidaniel@dimovska.edu'
'mnikolovska@mladenovski.com.mk'
'enaumovski@panovski.net'

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

Return type:: str
Examples:

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

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'matevska.mk'
'atanasova.org'
'tsvetkovska.org'
'gjorgjievska.com'
'matevski.edu'

domain_word() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'matevska'
'lazov'
'tsvetkovska'
'panovski'
'matevski'

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'ognen2012@example.com'
'deshanovskamartina@example.com'
'kuzmankrstev@example.com'
'sofija38@example.org'
'vasilkasimonovska@example.org'

free_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'ognen2012@neotel.mk'
'deshanovskamartina@alfa.mk'
'kuzmankrstev@telekom.mk'
'sofija38@hotmail.com'
'vasilkasimonovska@yahoo.com'

free_email_domain() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'neotel.mk'
'neotel.mk'
'gmail.com'
't.mk'
'mail.mk'

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.lazov.org'
'web-47.gjorgjievska.com'
'lt-24.martinovska.edu'
'email-92.gjorgiev.gov.mk'
'db-57.panovski.net'

http_method() → str¶

Returns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods

Return type:: str
Examples:

>>> 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
Example:: 404
Examples:

>>> 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
Examples:

>>> 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

Parameters:

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

Examples:

>>> 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://placekittens.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.

Parameters:

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

Returns:

IPv4

Examples:

>>> 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
Examples:

>>> 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.

Parameters:

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

Returns:

Private IPv4

Examples:

>>> 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.

Parameters:

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

Returns:

Public IPv4

Examples:

>>> 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

Examples:

>>> 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.

Parameters:: multicast – Multicast address
Returns:: MAC Address
Examples:

>>> 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
Examples:

>>> 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]
Examples:

>>> 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

Parameters:

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

Return type:

int

Examples:

>>> 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
Examples:

>>> 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¶

Examples:

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

safe_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'ognen2012@example.com'
'deshanovskamartina@example.com'
'kuzmankrstev@example.com'
'sofija38@example.org'
'vasilkasimonovska@example.org'

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

Django algorithm

Examples:

>>> 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¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'com.mk'
'org'
'com.mk'
'org'
'mk'

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

Parameters:

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://tsvetkovska.org/categorylogin.jsp'
'https://www.mladenovski.com.mk/main/main/mainprivacy.htm'
'https://trajkovski.mk/main/tag/tagsmain.asp'
'http://www.petkovska.com/list/blog/postsabout.html'
'https://www.nikolova.mk/postsmain.htm'

uri_extension() → str¶

Examples:

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

uri_page() → str¶

Examples:

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

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

Examples:

>>> 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¶

Parameters:: 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.
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://lazov.org/'
'https://gjorgjievska.com/'
'http://martinovska.edu/'
'http://lazarevska.com.mk/'
'https://panovski.net/'

user_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'ognen2012'
'atanasdeshanovski'
'trajan64'
'mitkomitrevski'
'lazarevskidaniel'

`faker.providers.job`¶

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

Bases: Provider

Job provider for mk_MK locale (Macedonian).

job() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Сoобраќаен инженер'
'Столар'
'Биолог'
'Мајстор'
'Финансиски аналитичар'

job_female() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Сoобраќаен инженер'
'Столар'
'Биолог'
'Мајстор'
'Финансиски аналитичар'

job_male() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Сoобраќаен инженер'
'Столар'
'Биолог'
'Мајстор'
'Финансиски аналитичар'

`faker.providers.lorem`¶

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

Bases: Provider

Lorem provider for mk_MK locale (Macedonian).

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

Get list of words.

ext_word_list is a parameter that allows the user to provide a list of words to be used instead of the built-in word list. If ext_word_list is provided, then the value of part_of_speech is ignored.

part_of_speech is a parameter that defines to what part of speech the returned word belongs. If ext_word_list is not None, then part_of_speech is ignored. If the value of part_of_speech does not correspond to an existent part of speech according to the set locale, then an exception is raised.

Warning

Depending on the length of a locale provider’s built-in word list or on the length of ext_word_list if provided, a large nb can exhaust said lists if unique is True, raising an exception.

Examples:

>>> 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¶

Generate a paragraph.

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.

Examples:

>>> 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]¶

Generate a list of paragraphs.

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.

Examples:

>>> 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¶

Generate a sentence.

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.

Examples:

>>> 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]¶

Generate a list of sentences.

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.

Examples:

>>> 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¶

Generate a text string.

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.

Examples:

>>> 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)
...
'Куќа надвор снег прво пие зошто. Волк заедно камен знаење слуша тесен. Каде лист тежок небесен слобода.'
'Сам срце денес лесен зема голем широк. Зборови вест многу село птица јазик.\nВино рака информација песок после татко овошје. Жито игра трева надвор.'
'Минато оган убав ладен кога развиток вест брат. Мал утре зборови пее сестра песна живее решение. Деца слобода топол пат.'
'Тесен плаче небо небо компјутер здравје. Камен куќа деца каде. Сон лошо топлина добро коњ.\nПрави вистина убавина лист. Орел леб река студ.'
'Гледа пие рака орел топол вистина. Млад создавање малку коњ доверба.'

>>> 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]¶

Generate a list of text strings.

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.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.texts(nb_texts=5)
...
['Куќа надвор снег прво пие зошто. Волк заедно камен знаење слуша тесен. Каде лист тежок небесен слобода.\nДобро гласен студ деца. Информација млад врата овошје леб железо.', 'Вино рака информација песок после татко овошје. Жито игра трева надвор.', 'Минато оган убав ладен кога развиток вест брат. Мал утре зборови пее сестра песна живее решение. Деца слобода топол пат.', 'Тесен плаче небо небо компјутер здравје. Камен куќа деца каде. Сон лошо топлина добро коњ.\nПрави вистина убавина лист. Орел леб река студ.', 'Гледа пие рака орел топол вистина. Млад создавање малку коњ доверба.\nПоддршка слаб пат леб сон вистина дрво. Заедно длабок луѓе куќа проблем плаче ден. Планина што стар очи лета каде.']
['Расте брат чувство лош спие убав брат. Сегашност време куќа гласен.\nДоле горе заедно куќа гледа ладен. Лесен добро млад план цвет врата волк. Мир иднина прашање.', 'Пријател брат земјиште град прашање светол. Прво мал идеја затоа. Сонце очи гледа вода.\nСемејство сребро вино снег.', 'Кога слобода соработка гласен малку земјиште сам вест. Што стар малку трева пред живот тежок.', 'Куче тивок учи. Кој чита лошо врата цвет небесен пие ветер. Висок култура таму место никогаш пишува.\nКоњ решение оган сон јаде може градење. Вода убав љубов образование пие ноќ.', 'Широк градење пат. Дава место небесен среќа вест ладен добар. Создавање може оган секогаш висок.']
['Внатре добро куќа чувство. Доле брз коњ. Историја може никогаш мал камен. Поддршка компјутер брат помош птица потоа после.', 'Небо полека врата врата бавен горе. Гледа наука темен после.\nПланина брат одговор внатре. Свет врата прашање внатре.\nСтар море кој мајка мачка вистина полека. Учи информација зборови слуша.', 'Стар млад лист идеја живот надвор. Храна план десно глава планина татко.\nДлабок правда ладен пред планина поддршка шума. Одговор железо развиток стар очи слуша наука.', 'Брзо лесен леб чита промена многу бавен. Орел град живее компјутер одговор. Тука брзо мисли небо тука знаење среќа.', 'Технологија чита ден тесен свет студ. Утре ако светол.\nЖивот куќа тесен што многу ладен. Мир куче село здравје трчи.']
['Земја стар многу успех чита тивок.\nТехнологија очи таму гледа знае секогаш разбирање ноќ. Брз добар жито зборува грижа сол чувство.', 'Чувство железо село рака многу можност. Мисла пее компјутер сребро градење. Одговор лесен пат после небо светлина лета.\nАко светлина сестра рака деца сака.', 'Лесен дава злато темнина стар. Историја сестра зема деца пее. Музика секогаш што живот цвет.', 'Цел стар игра малку правда река. Среќа врата сам земјиште. Култура среќа култура градење висок.\nЗемјиште прво широк свет орел снег интернет внатре. Лош слаб оган десно ветер телефон утре.', 'Одговор убавина време куче ноќ. Правда место мал свет пат уметност лош сонце.\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¶

Generate a word.

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

Examples:

>>> 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]¶

Generate a tuple of words.

The nb argument controls the number of words in the resulting list, and if ext_word_list is provided, words from that list will be used instead of those from the locale provider’s built-in word list.

if word_list is not provided, the method will use a default value of None, which will result in the method calling the get_words_list method to get the word list. If word_list is provided, the method will use the provided 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.

Examples:

>>> 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.mk_MK.Provider(generator: Any)¶

Bases: Provider

Passport provider for mk_MK locale (Macedonian).

Sources: - https://en.wikipedia.org/wiki/Macedonian_passport - https://en.wikipedia.org/wiki/Machine-readable_passport

Passport types: - P — Ordinary (burgundy cover, biometric) - PD — Diplomatic - PS — Official (службен)

Number format: 1 uppercase letter + 7 digits (9-char MRZ field, padded with ‘<’) ICAO/MRZ country code: MKD Validity: 2 years (under 4), 5 years (4–27), 10 years (27+)

passport_dob() → date¶

Generate a datetime date of birth.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.passport_dob()
...
datetime.date(2008, 6, 12)
datetime.date(1998, 6, 1)
datetime.date(1959, 4, 13)
datetime.date(1940, 7, 12)
datetime.date(1969, 10, 20)

passport_number() → str¶

Generate a passport number by replacing tokens to be alphanumeric

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.passport_number()
...
'Y6048764'
'L9382421'
'R9241157'
'L6593877'
'B8016097'

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

Generate a given_name and surname for a passport owner The gender argument is the gender marker of a passport owner, which is a one character string that is either male, female, or non-binary.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.passport_owner()
...
('Роза', 'Ристовски')
('Маја', 'Стојановска')
('Ристо', 'Бојаџиев')
('Јован', 'Атанасова')
('Трајан', 'Спасов')

`faker.providers.person`¶

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

Bases: Provider

Person provider for mk_MK locale (Macedonian).

Sources:

https://www.stat.gov.mk/Iminja_Preziminja.aspx (State Statistical Office of North Macedonia)
https://www.behindthename.com/names/usage/macedonian

first_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Роза'
'Огнен'
'Маја'
'Соња'
'Ристо'

first_name_female() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_female()
...
'Катерина'
'Сузана'
'Лилјана'
'Ангела'
'Димка'

first_name_male() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_male()
...
'Огнен'
'Ристо'
'Атанас'
'Јован'
'Христо'

first_name_nonbinary() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name_nonbinary()
...
'Роза'
'Огнен'
'Маја'
'Соња'
'Ристо'

language_name() → str¶

Generate a random i18n language name (e.g. English).

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.language_name()
...
'Luba-Katanga'
'Malay'
'Aymara'
'Interlingue'
'Quechua'

last_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name()
...
'Ристовска'
'Ристовски'
'Матевска'
'Стојановска'
'Стефановски'

last_name_female() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_female()
...
'Трајковска'
'Илиева'
'Симоновска'
'Цветковска'
'Јовановска'

last_name_male() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_male()
...
'Стојановски'
'Илиев'
'Поповски'
'Трајковски'
'Јовановски'

last_name_nonbinary() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.last_name_nonbinary()
...
'Ристовска'
'Ристовски'
'Матевска'
'Стојановска'
'Стефановски'

name() → str¶

Example:: ‘John Doe’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Проф. Ангела Дешановска'
'Проф. Теодора Тодоровска'
'Марија Зафировска'
'Проф. Даниел Димовски'
'Г-н Јане Цветковски'

name_female() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_female()
...
'Проф. Ангела Дешановска'
'Проф. Теодора Тодоровска'
'Проф. Јасмина Митревска'
'Мартина Велкова'
'Г-ца Сузана Василева'

name_male() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_male()
...
'Др. Атанас Дешановски'
'Др. Кузман Крстев'
'Проф. Жарко Лазаревски'
'Коста Велков'
'Јане Цветковски'

name_nonbinary() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name_nonbinary()
...
'Проф. Ангела Дешановска'
'Проф. Теодора Тодоровска'
'Марија Зафировска'
'Проф. Даниел Димовски'
'Г-н Јане Цветковски'

prefix() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'Проф.'
'Др.'
'Проф.'
'Проф.'
'Г-ца'

prefix_female() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_female()
...
'Проф.'
'Проф.'
'Г-ѓа'
'Др.'
'Проф.'

prefix_male() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_male()
...
'Др.'
'Др.'
'Г-н'
'Др.'
'Проф.'

prefix_nonbinary() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix_nonbinary()
...
'Проф.'
'Др.'
'Проф.'
'Проф.'
'Г-ца'

suffix() → str¶

Examples:

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

suffix_female() → str¶

Examples:

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

suffix_male() → str¶

Examples:

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

suffix_nonbinary() → str¶

Examples:

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

`faker.providers.phone_number`¶

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

Bases: Provider

Phone number provider for mk_MK locale (Macedonian).

Country code: +389 Skopje area code: 02 Other area codes: 03x Mobile prefixes: 07x

country_calling_code() → str¶

Examples:

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

msisdn() → str¶

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

Examples:

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

phone_number() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.phone_number()
...
'077 604 876'
'072 759 382'
'072 219 489'
'02411578156'
'075 938 778'

`faker.providers.ssn`¶

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

Bases: Provider

SSN provider for mk_MK locale (Macedonian).

The Macedonian EMBG (Единствен матичен број на граѓанинот) is a 13-digit unique citizen identification number with the format:

DDMMYYYRRGBBK

where:: DD - day of birth (01-31) MM - month of birth (01-12) YYY - last 3 digits of year of birth RR - region code (North Macedonia uses 41) G - gender and century digit (0-4 female, 5-9 male; odd=1900s, even=2000s) BB - sequence number within region/gender/day (00-99) K - checksum digit (MOD 11)

ssn() → str¶

Generate a valid Macedonian EMBG number.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'2507004410330'
'1308982413450'
'1704987417170'
'2002998414903'
'0510001410936'

Locale mk_MK¶

`faker.providers.address`¶

`faker.providers.automotive`¶

`faker.providers.bank`¶

`faker.providers.color`¶

`faker.providers.company`¶

`faker.providers.currency`¶

`faker.providers.date_time`¶

`faker.providers.geo`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.lorem`¶

`faker.providers.passport`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶

Table of Contents

Previous topic

Next topic

This Page

Locale mk_MK¶

faker.providers.address¶

faker.providers.automotive¶

faker.providers.bank¶

faker.providers.color¶

faker.providers.company¶

faker.providers.currency¶

faker.providers.date_time¶

faker.providers.geo¶

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.currency`¶

`faker.providers.date_time`¶

`faker.providers.geo`¶

`faker.providers.internet`¶

`faker.providers.job`¶

`faker.providers.lorem`¶

`faker.providers.passport`¶

`faker.providers.person`¶

`faker.providers.phone_number`¶

`faker.providers.ssn`¶