Locale hy_AM

faker.providers.address

class faker.providers.address.hy_AM.Provider(generator: Any)

Bases: Provider

address() str
Example:

‘791 Crist Parks, Sashabury, IL 86039-9874’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.address()
...
'ք. Ալավերդի, 2321, Միչուրինի 75, բն. 38'
'ք. Արթիկ, Օստրովսկու 89, բն. 4'
'ք. Վայք, Պետրոս Ադամյան 156'
'ք. Նոյեմբերյան, 4107, Սիլվա Կապուտիկյան 08'
'ք. Վեդի, Ֆիզկուլտուրնիկների 9'
administrative_unit() str
Example:

‘Կոտայք’

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()
...
'60'
'87'
'47'
'93'
'242'
city() str
Example:

‘Բյուրեղավան’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Իջևան'
'Քաջարան'
'Կապան'
'Ալավերդի'
'Դաստակերտ'
city_prefix() str
Example:

‘ք.’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_prefix()
...
'ք.'
'ք.'
'ք.'
'ք.'
'ք.'
city_suffix() str
Example:

‘town’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city_suffix()
...
''
''
''
''
''
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'
current_country() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country()
...
'Armenia'
'Armenia'
'Armenia'
'Armenia'
'Armenia'
current_country_code() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.current_country_code()
...
'AM'
'AM'
'AM'
'AM'
'AM'
postcode() str
Example:

‘3159’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode()
...
'3355'
'3645'
'0531'
'2321'
'4180'
postcode_in_state(state_abbr: str | None = None) str
Example:

‘4703’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.postcode_in_state()
...
'3030'
'0332'
'3848'
'2910'
'3383'
secondary_address() str
Example:

‘բն. 49’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.secondary_address()
...
'բն. 60'
'բն. 87'
'բն. 47'
'բն. 93'
'բն. 24'
state() str
Example:

‘Կոտայք’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state()
...
'Շիրակ'
'Շիրակ'
'Արագածոտն'
'Լոռի'
'Տավուշ'
state_abbr() str
Example:

‘ՎՁ’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.state_abbr()
...
'ՇԿ'
'ՇԿ'
'ԱԳ'
'ԼՌ'
'ՎՁ'
street() str
Example:

‘Ոսկերիչների’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street()
...
'Ղազար Փարպեցու'
'Մովսես Խորենացու'
'Սայաթ-Նովայի'
'Լենինգրադյան'
'Սարյան'
street_address() str
Example:

‘791 Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_address()
...
'Սայաթ-Նովայի 87'
'Պռոշյան 93'
'Բուդապեշտի 9'
'Կասյան 1'
'Վահրամ Փափազյան 5'
street_name() str
Example:

‘Crist Parks’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_name()
...
'Մովսես Խորենացու'
'Լենինգրադյան'
'Միչուրինի'
'Պռոշյան'
'Տարսոնի'
street_prefix() str
Example:

‘փողոց’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.street_prefix()
...
'պողոտա'
'պողոտա'
'փողոց'
'պողոտա'
'պողոտա'
street_suffix() str
Example:

‘Avenue’

Examples:

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

‘Ոսկեվազ’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.village()
...
'Լանջիկ'
'Վարդաղբյուր'
'Զովասար'
'Գեղաքար'
'Արծվաբերդ'
village_prefix() str
Example:

‘գ.’

Examples:

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

faker.providers.color

class faker.providers.color.hy_AM.Provider(generator: Any)

Bases: Provider

Implement color provider for hy_AM locale.

color(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None, color_format: str = 'hex') str

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)'
color_hsl(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[int, int, int]

Generate a HSL color tuple in a human-friendly way.

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)
color_hsv(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[int, int, int]

Generate a HSV color tuple in a human-friendly way.

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)
color_name() str

Generate a color name.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.color_name()
...
'Մուգ կարմիր'
'Մուգ վարդագույն'
'Բաց կանաչ'
'Կարմիր'
'Վուշ'
color_rgb(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[int, int, int]

Generate a RGB color tuple of integers in a human-friendly way.

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)
color_rgb_float(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) Tuple[float, float, float]

Generate a RGB color tuple of floats in a human-friendly way.

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

Bases: Provider

bs() str
Example:

‘integrate extensible convergence’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.bs()
...
'վերափոխել համատարած շուկաներ'
'ինտեգրել էլեկտրոնային օգտագործողներ'
'արտադրանքի վերածել գրավիչ տեխնոլոգիաներ'
'զարգացնել դինամիկ ցանցեր'
'դրամայնացնել պատրաստի նախաձեռնություններ'
catch_phrase() str
Example:

‘Robust full-range hub’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.catch_phrase()
...
'վիրտուալ տեղային ապահովված գիծ'
'ավտոմատացված բարձր մակարդակի աշխատուժ'
'օրգանական լոգիստիկ գիտելիքների բազա'
'օպտիմալացված միջանկյալ գործառույթ'
'կազմակերպված հստակ մտածող ինտերֆեյս'
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.date_time

class faker.providers.date_time.hy_AM.Provider(generator: Any)

Bases: Provider

am_pm() str
Examples:

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

‘XVII’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.century()
...
'XIII'
'XIV'
'II'
'IX'
'XVII'
date(pattern: str = '%Y-%m-%d', end_datetime: date | datetime | timedelta | str | int | None = None) str

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

Parameters:

pattern – Format of the date (year-month-day by default)

Example:

‘2008-11-27’

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'2016-05-13'
'2011-08-14'
'1993-02-03'
'1984-03-20'
'1998-01-27'
date_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'today') date

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 – Defaults to 30 years ago

  • end_date – Defaults to “today”

Example:

Date(‘1999-02-02’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2020, 3, 28)
datetime.date(2017, 8, 23)
datetime.date(2007, 7, 10)
datetime.date(2002, 9, 3)
datetime.date(2010, 3, 30)
date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) date

Takes two Date objects and returns a random date between the two given dates. Accepts Date or datetime objects

Parameters:
  • date_start – Date

  • date_end – Date

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2024, 11, 27)
datetime.date(2024, 11, 27)
datetime.date(2024, 11, 27)
datetime.date(2024, 11, 27)
datetime.date(2024, 11, 27)
date_object(end_datetime: datetime | None = None) date

Get a date object between January 1, 1970 and now

Example:

datetime.date(2016, 9, 20)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(2016, 5, 13)
datetime.date(2011, 8, 14)
datetime.date(1993, 2, 3)
datetime.date(1984, 3, 20)
datetime.date(1998, 1, 27)
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.

Example:

Date(‘1979-02-02’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2006, 11, 10)
datetime.date(1996, 10, 29)
datetime.date(1957, 9, 10)
datetime.date(1938, 12, 10)
datetime.date(1968, 3, 19)
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

  • after_today – include days in current century after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2021, 1, 11)
datetime.date(2018, 11, 17)
datetime.date(2010, 6, 22)
datetime.date(2006, 6, 13)
datetime.date(2012, 9, 25)
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

  • after_today – include days in current decade after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2024, 2, 22)
datetime.date(2023, 9, 20)
datetime.date(2022, 1, 23)
datetime.date(2021, 4, 8)
datetime.date(2022, 7, 5)
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

  • after_today – include days in current month after today

Example:

dtdate(‘2012-04-04’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2024, 11, 22)
datetime.date(2024, 11, 20)
datetime.date(2024, 11, 11)
datetime.date(2024, 11, 7)
datetime.date(2024, 11, 14)
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

  • after_today – include days in current year after today

Example:

Date(‘2012-04-04’)

Returns:

Date

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2024, 10, 6)
datetime.date(2024, 9, 7)
datetime.date(2024, 5, 19)
datetime.date(2024, 3, 26)
datetime.date(2024, 6, 18)
date_time(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None) datetime

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

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2005-08-16 20:39:21’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2016, 5, 13, 20, 35, 21, 725378)
datetime.datetime(2011, 8, 14, 18, 7, 54, 919850)
datetime.datetime(1993, 2, 3, 13, 14, 46, 401175)
datetime.datetime(1984, 3, 20, 13, 38, 45, 19942)
datetime.datetime(1998, 1, 27, 14, 25, 27, 226886)
date_time_ad(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) datetime

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

Parameters:

tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘1265-03-22 21:15:52’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(1710, 1, 12, 23, 10, 17, 195236)
datetime.datetime(1535, 1, 12, 18, 14, 8, 803223)
datetime.datetime(852, 3, 13, 15, 37, 38, 445168)
datetime.datetime(525, 1, 9, 15, 45, 25, 989792)
datetime.datetime(1035, 10, 10, 22, 51, 8, 219090)
date_time_between(start_date: date | datetime | timedelta | str | int = '-30y', end_date: date | datetime | timedelta | str | int = 'now', tzinfo: tzinfo | None = None) datetime

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 – Defaults to 30 years ago

  • end_date – Defaults to “now”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2020, 3, 29, 6, 32, 37, 236214)
datetime.datetime(2017, 8, 24, 19, 57, 23, 808743)
datetime.datetime(2007, 7, 12, 1, 27, 4, 361449)
datetime.datetime(2002, 9, 4, 18, 37, 40, 49189)
datetime.datetime(2010, 3, 31, 21, 54, 36, 171082)
date_time_between_dates(datetime_start: date | datetime | timedelta | str | int | None = None, datetime_end: date | datetime | timedelta | str | int | None = None, tzinfo: tzinfo | None = None) datetime

Takes two datetime objects and returns a random datetime between the two given datetimes. Accepts datetime objects.

Parameters:
  • datetime_start – datetime

  • datetime_end – datetime

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2024, 11, 27, 23, 21, 54)
datetime.datetime(2024, 11, 27, 23, 21, 54)
datetime.datetime(2024, 11, 27, 23, 21, 54)
datetime.datetime(2024, 11, 27, 23, 21, 54)
datetime.datetime(2024, 11, 27, 23, 21, 54)
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

  • after_now – include days in current century after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2021, 1, 12, 12, 39, 50, 98758)
datetime.datetime(2018, 11, 17, 20, 22, 42, 563190)
datetime.datetime(2010, 6, 23, 8, 22, 43, 516642)
datetime.datetime(2006, 6, 13, 14, 49, 33, 52198)
datetime.datetime(2012, 9, 25, 13, 31, 59, 882989)
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

  • after_now – include days in current decade after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2024, 2, 23, 0, 37, 29, 665020)
datetime.datetime(2023, 9, 20, 23, 48, 45, 238612)
datetime.datetime(2022, 1, 24, 1, 46, 9, 132093)
datetime.datetime(2021, 4, 9, 5, 32, 28, 271293)
datetime.datetime(2022, 7, 5, 16, 50, 56, 941749)
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

  • after_now – include days in current month after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2024, 11, 23, 18, 38, 56, 946885)
datetime.datetime(2024, 11, 21, 10, 40, 23, 347414)
datetime.datetime(2024, 11, 12, 8, 15, 47, 957129)
datetime.datetime(2024, 11, 7, 23, 36, 49, 111392)
datetime.datetime(2024, 11, 14, 18, 58, 52, 895996)
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

  • after_now – include days in current year after today

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

datetime(‘2012-04-04 11:02:02’)

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2024, 10, 7, 7, 49, 1, 578273)
datetime.datetime(2024, 9, 8, 14, 53, 57, 773697)
datetime.datetime(2024, 5, 19, 14, 50, 50, 255183)
datetime.datetime(2024, 3, 26, 22, 53, 3, 315112)
datetime.datetime(2024, 6, 18, 17, 30, 44, 353501)
day_of_month() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'13'
'14'
'03'
'20'
'27'
day_of_week()
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'Ուրբաթ'
'Կիրակի'
'Չորեքշաբթի'
'Երեքշաբթի'
'Երեքշաբթի'
future_date(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) date

Get a Date object based on a random date between 1 day from now and a given date. Accepts date strings that can be recognized by strtotime().

Parameters:
  • end_date – Defaults to “+30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

dtdate(‘2030-01-01’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2024, 12, 22)
datetime.date(2024, 12, 19)
datetime.date(2024, 12, 10)
datetime.date(2024, 12, 5)
datetime.date(2024, 12, 12)
future_datetime(end_date: date | datetime | timedelta | str | int = '+30d', tzinfo: tzinfo | None = None) datetime

Get a datetime object based on a random date between 1 second form now and a given date. Accepts date strings that can be recognized by strtotime().

Parameters:
  • end_date – Defaults to “+30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2024, 12, 23, 7, 20, 55, 594731)
datetime.datetime(2024, 12, 20, 17, 5, 32, 54467)
datetime.datetime(2024, 12, 10, 14, 10, 36, 116942)
datetime.datetime(2024, 12, 5, 17, 47, 6, 957843)
datetime.datetime(2024, 12, 13, 7, 28, 58, 566513)
iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') str

Get a timestamp in ISO 8601 format (or one of its profiles).

Parameters:
  • tzinfo – timezone, instance of datetime.tzinfo subclass

  • sep – separator between date and time, defaults to ‘T’

  • timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation

Example:

‘2003-10-21T16:05:52+0000’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'2016-05-13T20:35:21.725378'
'2011-08-14T18:07:54.919850'
'1993-02-03T13:14:46.401175'
'1984-03-20T13:38:45.019942'
'1998-01-27T14:25:27.226886'
month() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month()
...
'05'
'08'
'02'
'03'
'01'
month_name()
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.month_name()
...
'Մայիս'
'Օգոստոս'
'Փետրվար'
'Մարտ'
'Հունվար'
past_date(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) date

Get a Date object based on a random date between a given date and 1 day ago. Accepts date strings that can be recognized by strtotime().

Parameters:
  • start_date – Defaults to “-30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

dtdate(‘1999-02-02’)

Returns:

dtdate

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2024, 11, 21)
datetime.date(2024, 11, 18)
datetime.date(2024, 11, 9)
datetime.date(2024, 11, 4)
datetime.date(2024, 11, 11)
past_datetime(start_date: date | datetime | timedelta | str | int = '-30d', tzinfo: tzinfo | None = None) datetime

Get a datetime object based on a random date between a given date and 1 second ago. Accepts date strings that can be recognized by strtotime().

Parameters:
  • start_date – Defaults to “-30d”

  • tzinfo – timezone, instance of datetime.tzinfo subclass

Example:

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

Returns:

datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2024, 11, 23, 7, 20, 54, 594731)
datetime.datetime(2024, 11, 20, 17, 5, 31, 54467)
datetime.datetime(2024, 11, 10, 14, 10, 35, 116942)
datetime.datetime(2024, 11, 5, 17, 47, 5, 957843)
datetime.datetime(2024, 11, 13, 7, 28, 57, 566513)
pytimezone(*args: Any, **kwargs: Any) tzinfo | None

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

Example:

faker.pytimezone()

Returns:

dateutil.tz.tz.tzfile

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pytimezone()
...
tzfile('/usr/share/zoneinfo/Indian/Maldives')
tzfile('/usr/share/zoneinfo/America/Barbados')
tzfile('/usr/share/zoneinfo/Europe/Stockholm')
tzfile('/usr/share/zoneinfo/Africa/Windhoek')
tzfile('/usr/share/zoneinfo/Asia/Qatar')
time(pattern: str = '%H:%M:%S', end_datetime: date | datetime | timedelta | str | int | None = None) str

Get a time string (24h format by default)

Parameters:

pattern – format

Example:

‘15:02:34’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'20:35:21'
'18:07:54'
'13:14:46'
'13:38:45'
'14:25:27'
time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) timedelta

Get a timedelta object

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)
time_object(end_datetime: date | datetime | timedelta | str | int | None = None) time

Get a time object

Example:

datetime.time(15, 56, 56, 772876)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(20, 35, 21, 725378)
datetime.time(18, 7, 54, 919850)
datetime.time(13, 14, 46, 401175)
datetime.time(13, 38, 45, 19942)
datetime.time(14, 25, 27, 226886)
time_series(start_date: date | datetime | timedelta | str | int = '-30d', end_date: date | datetime | timedelta | str | int = 'now', precision: float | None = None, distrib: Callable[[datetime], float] | None = None, tzinfo: tzinfo | None = None) Iterator[Tuple[datetime, Any]]

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. distrib is a callable that accepts <datetime> and returns <value>

Examples:

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

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.timezone()
...
'Indian/Maldives'
'America/Barbados'
'Europe/Stockholm'
'Africa/Windhoek'
'Asia/Qatar'
unix_time(end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) float

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.

Example:

1061306726.6

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
1463171721.7253776
1313345274.9198499
728745286.4011745
448637925.0199417
885911127.2268862
year() str
Examples:

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

faker.providers.job

class faker.providers.job.hy_AM.Provider(generator: Any)

Bases: Provider

job() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job()
...
'Ռեստորանի կառավարիչ'
'Նավթային ինժեներ'
'Դեղագործ'
'Վիրաբույժ'
'Ֆինանսական խորհրդատու'
job_female() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_female()
...
'Ռեստորանի կառավարիչ'
'Նավթային ինժեներ'
'Դեղագործ'
'Վիրաբույժ'
'Ֆինանսական խորհրդատու'
job_male() str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.job_male()
...
'Ռեստորանի կառավարիչ'
'Նավթային ինժեներ'
'Դեղագործ'
'Վիրաբույժ'
'Ֆինանսական խորհրդատու'

faker.providers.lorem

class faker.providers.lorem.hy_AM.Provider(generator: Any)

Bases: Provider

Implement lorem provider for hy_AM locale.

Sources:

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Սև մեռնել երկինք չոր խաղալ լիճ.', 'Ուրիշ ընկնել լողալ նստել այստեղ պոչ աստղ ատամ. Լավ այն որոշ պարան ծանր օձ գլուխ լուսին. Պոզ երկինք կեղտոտ մենք ապրել խոտ.\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.person

class faker.providers.person.hy_AM.Provider(generator: Any)

Bases: Provider

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

Bases: Provider

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()
...
'10-604876'
'275.93824'
'(219) 48924'
'315-78156'
'393.87784'