# Locale uk_UA

## `faker.providers.address`

class faker.providers.address.uk_UA.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()
        ...
        'вулиця Кільцева, буд. 764 кв. 59, Яготин, 29631'
        'провулок Бузковий 1-й, буд. 489 кв. 4, Борислав, 96660'
        'парк Сливова, буд. 5 кв. 59, Путивль, 27801'
        'шосе Кладовищенська, буд. 8 кв. 1, Сміла, 53274'
        'узвіз Карантинна, буд. 513 кв. 332, Українка, 72170'

  building_number() → str
    Example:

      ‘791’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number()
        ...
        '60'
        '87'
        '47'
        '93'
        '242'

  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_prefix() → str
    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()
        ...
        '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()
        ...
        'Ukraine'
        'Ukraine'
        'Ukraine'
        'Ukraine'
        'Ukraine'

  current_country_code() → str
    Examples:

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

  postcode() → str

    The code consists of five digits (01000-99999)

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode()
        ...
        '51494'
        '56125'
        '06306'
        '34936'
        '68013'

  region() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.region()
        ...
        'Львівська область'
        'Чернігівська область'
        'Миколаївська область'
        'Вінницька область'
        'Івано-Франківська область'

  street_address() → str
    Example:

      ‘791 Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_address()
        ...
        'сквер Сергія Єфремова, буд. 87 кв. 47'
        'площа Прохоровський, буд. 4 кв. 1'
        'шосе Творча, буд. 4 кв. 1'
        'парк Сливова, буд. 5 кв. 59'
        'шосе Пішонівська, буд. 84'

  street_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_name()
        ...
        'Михайла Грушевського'
        'Чигиринська'
        'Сергія Єфремова'
        'Кільцева'
        'Разумовська'

  street_prefix() → str
    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()
        ...
        'Street'
        'Street'
        'Street'
        'Street'
        'Street'

  street_title() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_title()
        ...
        'сквер Чигиринська'
        'вулиця Кільцева'
        'шосе Посівна'
        'сквер Ланжеронівська'
        'парк Сергія Параджанова'

## `faker.providers.automotive`

class faker.providers.automotive.uk_UA.Provider(generator: Any)

  Bases: `Provider`

  diplomatic_license_plate() → str

    Example: ‘CDP 000’ or ‘DP 000 000’ or ‘S 000 000’ format

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.diplomatic_license_plate()
        ...
        'DP 964 494'
        'S 876 530'
        'CDP 141'
        'CDP 623'
        'S 514 902'

  license_plate(region_name: str | None = None, temporary_plate: bool = False) → str

    Generate a license plate.

    - If `region_name` is `None` (default), its value will be set to a random.

    - If `region_name` is `Kyiv`, will use this region in build of license plates.

    - If `temporary_plate` is `False` (default), generate license plate AA0000AA format

    - If `temporary_plate` is `True`, generate temporary plate format 01 AA0000

    - 01 - 27 it’s region number

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate()
        ...
        'MO6048HT'
        'NE4759MK'
        'EX4219HI'
        'RE4115AT'
        'TK5659HN'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate(region_name=None, temporary_plate=False)
        ...
        'AM6048HT'
        'AT4759MK'
        'II4219HI'
        'RR4115AT'
        'BE5659HN'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate(region_name=None, temporary_plate=True)
        ...
        '11 AA6048'
        '04 RR6475'
        '10 ME8242'
        '07 AO9489'
        '11 KA4115'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate(region_name="Kyiv", temporary_plate=False)
        ...
        'TT6048HT'
        'TA4759MK'
        'TA4219HI'
        'TA4115AT'
        'TA5659HN'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate(region_name="Kyiv", temporary_plate=True)
        ...
        '11 TA6048'
        '11 KA6475'
        '11 KA8242'
        '11 TA9489'
        '11 KA4115'

  plate_letter_prefix(region_name: str | None = None) → str

    Generate a letter for license plates.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.plate_letter_prefix()
        ...
        'SN'
        'EI'
        'XX'
        'SE'
        'MH'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.plate_letter_prefix(region_name="Kyiv")
        ...
        'TT'
        'TT'
        'TT'
        'TT'
        'TT'

  plate_letter_suffix() → str

    Generate a end letter for license plates.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.plate_letter_suffix()
        ...
        'CO'
        'XO'
        'TA'
        'KI'
        'TT'

  plate_number() → str

    Generate a number for license plates.

    Examples:

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

  plate_region_code(region_name: str | None = None) → str

    Generate plate region number

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.plate_region_code()
        ...
        '00'
        '14'
        '11'
        '18'
        '15'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.plate_region_code(region_name="Kyiv")
        ...
        '11'
        '11'
        '11'
        '11'
        '11'

  vehicle_category() → str

    Generate a vehicle category code for license plates.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.vehicle_category()
        ...
        'T'
        'D1'
        'DE'
        'D1'
        'A1'

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

  Bases: `Provider`

  Implement bank provider for `uk_UA` locale. Source for rules for bban format: https://bank.gov.ua/en/iban Banks list: https://ubanks.com.ua/adr/

  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()
        ...
        'UA'
        'UA'
        'UA'
        'UA'
        'UA'

  bban() → str

    Generate a Basic Bank Account Number (BBAN).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bban()
        ...
        '660487647593824219489241157'
        '815659387784080160975351393'
        '328711587148418583989471965'
        '934232094711220186848339694'
        '775159179533041352560123098'

  iban() → str

    Generate an International Bank Account Number (IBAN).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iban()
        ...
        'UA25660487647593824219489241157'
        'UA58815659387784080160975351393'
        'UA06328711587148418583989471965'
        'UA25934232094711220186848339694'
        'UA04775159179533041352560123098'

  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()
        ...
        'YNBIUA65ZT4'
        'SGQEUASIGQ8'
        'JDXCUAV4'
        'LNKTUAN9'
        'OQIBUA9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=8)
        ...
        'MYNBUAQ6'
        'PMZJUA4W'
        'SGQEUASI'
        'YDTZUAQ8'
        'WZTEUATG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=8, use_dataset=True)
        ...
        'MYNBUAQ6'
        'PMZJUA4W'
        'SGQEUASI'
        'YDTZUAQ8'
        'WZTEUATG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11)
        ...
        'MYNBUAQ65ZT'
        'PLSGUA6ISIG'
        'TZIRUAJTGEV'
        'PRDLUA1UN94'
        'OQIBUA9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, primary=True)
        ...
        'MYNBUAQ6XXX'
        'PMZJUA4WXXX'
        'SGQEUASIXXX'
        'YDTZUAQ8XXX'
        'WZTEUATGXXX'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, use_dataset=True)
        ...
        'MYNBUAQ65ZT'
        'PLSGUA6ISIG'
        'TZIRUAJTGEV'
        'PRDLUA1UN94'
        'OQIBUA9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, primary=True, use_dataset=True)
        ...
        'MYNBUAQ6XXX'
        'PMZJUA4WXXX'
        'SGQEUASIXXX'
        'YDTZUAQ8XXX'
        'WZTEUATGXXX'

  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()
        ...
        'MYNBUAQ65ZT'
        'PLSGUA6ISIG'
        'TZIRUAJTGEV'
        'PRDLUA1UN94'
        'OQIBUA9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift11(use_dataset=True)
        ...
        'MYNBUAQ65ZT'
        'PLSGUA6ISIG'
        'TZIRUAJTGEV'
        'PRDLUA1UN94'
        'OQIBUA9AFZA'

  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()
        ...
        'MYNBUAQ6'
        'PMZJUA4W'
        'SGQEUASI'
        'YDTZUAQ8'
        'WZTEUATG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift8(use_dataset=True)
        ...
        'MYNBUAQ6'
        'PMZJUA4W'
        'SGQEUASI'
        'YDTZUAQ8'
        'WZTEUATG'

## `faker.providers.color`

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

  Bases: `Provider`

  Implement color provider for `uk_UA` locale.

  Sources: - https://uk.wikipedia.org/wiki/Список_кольорів

  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.

    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)

  color_hsv(hue: str | float | int | Sequence[int] | None = None, luminosity: str | None = None) → Tuple[int, int, int]

    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()
        ...
        'Малахітовий'
        'Шоколадний'
        'Ніжно-оливковий'
        'Баклажановий'
        'Зелений папороть'

  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.

    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)

  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.

    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()
        ...
        'aqua'
        'teal'
        'fuchsia'
        'white'
        'teal'

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

class faker.providers.credit_card.uk_UA.Provider(generator: Any)

  Bases: `Provider`

  Implement credit card provider for `uk_UA` locale. https://blog.ipay.ua/uk/sekrety-bankovskix-kart-kak-identificirovat-bank-po-nomeru-karty/

  credit_card_expire(start: date | datetime | timedelta | str | int = 'now', end: date | datetime | timedelta | str | int = '+10y', date_format: str = '%m/%y') → str

    Generate a credit card expiry date.

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

    Examples:

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

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

    Generate UA Credit Card: Supported card types ‘visa’, ‘mastercard’, ‘prostir’, ‘maestro’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.credit_card_full()
        ...
        'Maestro\nAnastasiia Konoplenko\n6762647593824215 03/32\nCVV: 489\nБанк Фамільний'
        'ПРОСТІР\nPylyp Vakulenko\n9781565938778402 01/34\nCVC2: 801\nПриватБанк'
        'Visa\nMilena Karmaliuk\n4139332871158716 12/28\nCVV2: 418\nОТП Банк'
        'Mastercard\nOryna Vermenych\n5459342320947113 10/32\nCVC2: 220\nБанк Авангард'
        'Maestro\nKlavdiia Zatovkaniuk\n6762947751591790 04/32\nCVV: 330\nКристалбанк'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.credit_card_full(card_type="prostir")
        ...
        'ПРОСТІР\nOkseniia Babenko\n9876475938242191 12/33\nCVC2: 892\nМТБ Банк'
        'ПРОСТІР\nPylyp Vakulenko\n9781565938778402 01/34\nCVC2: 801\nПриватБанк'
        'ПРОСТІР\nOleh Yarosh\n9351393328711580 12/35\nCVC2: 714\nМіжнародний Інвестиційний Банк'
        'ПРОСТІР\nMartyn Petliura\n9989471965934234 03/34\nCVC2: 094\nТАСкомбанк'
        'ПРОСТІР\nArsen Huk\n9018684833969472 11/30\nCVC2: 515\nБанк інвестицій та заощаджень'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.credit_card_full(card_type="mastercard")
        ...
        'Mastercard\nOkseniia Babenko\n5387647593824212 03/32\nCVC2: 489\nБанк Фамільний'
        'Mastercard\nVarvara Vakulenko\n5378156593877841 08/26\nCVC2: 801\nПриватБанк'
        'Mastercard\nOleh Yarosh\n5335139332871152 09/34\nCVC2: 714\nМіжнародний Інвестиційний Банк'
        'Mastercard\nMartyn Petliura\n5298947196593422 11/27\nCVC2: 209\nКредобанк'
        'Mastercard\nHanna Verhun\n5220186848339693 09/28\nCVC2: 751\nОксі Банк'

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

    Generate a valid credit card number.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.credit_card_number()
        ...
        '6762048764759381'
        '5321948924115786'
        '4659387784080167'
        '4535139332871153'
        '6762484185839892'

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

    Generate a credit card provider name.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.credit_card_provider()
        ...
        'Maestro'
        'Maestro'
        'Visa'
        'ПРОСТІР'
        'Maestro'

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

    Generate a credit card security code.

    Examples:

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

## `faker.providers.currency`

class faker.providers.currency.uk_UA.Provider(generator: Any)

  Bases: `Provider`

  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()
        ...
        ('NGN', 'Ніґерійська найра')
        ('PHP', 'Філіппінський песо')
        ('BAM', 'Конвертовна марка Боснії і Герцоговини')
        ('JPY', 'Японська єна')
        ('THB', 'Таїландський бат')

  currency_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.currency_code()
        ...
        'NGN'
        'PHP'
        'BAM'
        'JPY'
        'THB'

  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()
        ...
        '7 604,87\xa0грн.'
        '975,93\xa0грн.'
        '54,21\xa0грн.'
        '89 241,15\xa0грн.'
        '91 565,93\xa0грн.'

## `faker.providers.internet`

class faker.providers.internet.uk_UA.Provider(generator: Any)

  Bases: `Provider`

  ascii_company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_company_email()
        ...
        'ahaivoronska@andriichuk.org'
        'ehavrylyshyn@deineko-tsisyk.ua'
        'mykolailutsenko@ivashchenko.ua'
        'oleksazhalilo@danko.org'
        'zakusyloustym@zasenko-levchenko.info'

  ascii_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_email()
        ...
        'qvatamaniuk@meta.ua'
        'ehavrylyshyn@gov.ua'
        'mykolailutsenko@ivashchenko.ua'
        'venedykt15@havryliv-zhurba.net'
        'liubov38@i.ua'

  ascii_free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_free_email()
        ...
        'ahaivoronska@email.ua'
        'bohuslava76@gov.ua'
        'lzakharchenko@gmail.com'
        'mykolailutsenko@email.ua'
        'violetta92@gov.ua'

  ascii_safe_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_safe_email()
        ...
        'ahaivoronska@example.org'
        'bohuslava76@example.com'
        'lzakharchenko@example.org'
        'mykolailutsenko@example.org'
        'violetta92@example.com'

  company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_email()
        ...
        'ahaivoronska@andriichuk.org'
        'ehavrylyshyn@deineko-tsisyk.ua'
        'mykolailutsenko@ivashchenko.ua'
        'oleksazhalilo@danko.org'
        'zakusyloustym@zasenko-levchenko.info'

  dga(year: int | None = None, month: int | None = None, day: int | None = None, tld: str | None = None, length: int | None = None) → str

    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'
        'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamohcpnldug.net'
        'iiulfpgbvqcdaehnqkbxmaqgkykorlxnwy.info'
        'cpyhexmtvewxpwiiaxtgdfajuhbsyaaykvgkgreki.com'
        'uqniukqjckmjabijnuqholpsjayatffafysbsyaaytuquhbpmpviajxnaro.ua'

  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()
        ...
        'haivoronska-pustovit.com'
        'aleksiichuk-shtokalo.org'
        'chupryna-zakharchenko.ua'
        'chalyi.net'
        'bazylevska.ua'

  domain_word() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.domain_word()
        ...
        'haivoronska-pustovit'
        'andriichuk'
        'oliinyk-havrylyshyn'
        'zakharchenko-deineko'
        'chalyi'

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.email()
        ...
        'ahaivoronska@example.org'
        'bohuslava76@example.com'
        'lzakharchenko@example.org'
        'mykolailutsenko@example.org'
        'violetta92@example.com'

  free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email()
        ...
        'ahaivoronska@email.ua'
        'bohuslava76@gov.ua'
        'lzakharchenko@gmail.com'
        'mykolailutsenko@email.ua'
        'violetta92@gov.ua'

  free_email_domain() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email_domain()
        ...
        'i.ua'
        'i.ua'
        'email.ua'
        'gov.ua'
        'meta.ua'

  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.andriichuk.org'
        'laptop-47.deineko-tsisyk.ua'
        'srv-42.ivashchenko.ua'
        'email-92.zhalilo-chmil.com'
        'web-57.zhurba.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://placekitten.com/286/194'

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

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

    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()
        ...
        'ahaivoronska@example.org'
        'bohuslava76@example.com'
        'lzakharchenko@example.org'
        'mykolailutsenko@example.org'
        'violetta92@example.com'

  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()
        ...
        'org'
        'org'
        'com'
        'net'
        'ua'

  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://havrylyshyn-chupryna.net/categorylogin.jsp'
        'http://www.tytarenko.net/main/mainprivacy.htm'
        'http://www.chupryna.net/search/categories/categoryhomepage.htm'
        'http://www.palii.ua/exploreauthor.php'
        'https://hrechko.info/explorehomepage.html'

  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://andriichuk.org/'
        'https://zakharchenko-deineko.info/'
        'http://bazylevska.ua/'
        'https://www.zhalilo-chmil.com/'
        'https://zhurba.net/'

  user_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.user_name()
        ...
        'ahaivoronska'
        'andriichukbohuslava'
        'yoliinyk'
        'alina59'
        'hannalupii'

## `faker.providers.job`

class faker.providers.job.uk_UA.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.uk_UA.Provider(generator: Any)

  Bases: `Provider`

  Implement lorem provider for `uk_UA` locale.

  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)
        ...
        'Міф ремінь казна-хто пропаганда хліб один. Процес ковзати космос робочий кордон редактор. Збільшуватися поява пірʼя колектив плавно.'
        'Зрозумілий прощення виднітися дихання солома упор промовчати. Шкіра легко здригнутися наполегливо дрімати диявол.'
        'Колектив плід вчора сміятися коричневий прохід простір. Зображати порт дорогий пробувати. Прірва встати рот банк.'
        'Ґаздиня салон що адвокат. Яблуко через незручно серйозний.'
        'Решітка хліб гідність інтернет основа ідея. Вітрина падати прошепотіти дрімати покидати.'

        >>> 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Колишній поява слати написати пірʼя ставити.', "Розвинений метелик дихання підземний міф від'їзд кут вскакивать. Знімати зображати синок близько число знищення синок вираз. Порівняння ліловий спорт приятель адвокат труп."]

        >>> 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.uk_UA.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()
        ...
        'Святослав'
        'Тарас'
        'Аркадій'
        'Кирило'
        'Богуслава'

  full_name(gender: Literal['M', 'F', 'X'] | None = None, short: bool | None = False) → str
    Generate Full Name

      - gender = ‘M’ or ‘F’ optional params

      - short: bool optional params. default is False

    Example:

      ‘Петриченко Петро Сергійович’

    Example:

      ‘Петриченко П.С.’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.full_name()
        ...
        'Бабенко Оксенія Геннадіївна'
        'Непорожній Одарка Леопольдівна'
        'Гаврилишина Ірена Болеславівна'
        'Верховинець Володимира Орестівна'
        'Овсієнко Галина Артемівна'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.full_name(gender='F')
        ...
        'Фоменко Соломія Алевтинівна'
        'Зарудна Лілія Лукʼянівна'
        'Непорожній Одарка Леопольдівна'
        'Захарченко Пріска Макарівна'
        'Мазепа Володимира Болеславівна'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.full_name(gender='M')
        ...
        'Стельмах Теодор Тарасович'
        'Фоменко Феофан Алевтинович'
        'Чалий Геннадій Максимович'
        'Непорожній Ілля Макарович'
        'Захарченко Захар Микитович'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.full_name(short=True)
        ...
        'Бабенко О.Г.'
        'Непорожній О.Л.'
        'Гаврилишина І.Б.'
        'Верховинець В.О.'
        'Овсієнко Г.А.'

  language_name() → str

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.language_name()
        ...
        'Лаоська'
        'Монгольська'
        'Аймара'
        'Інтерлінгва'
        'Польська'

  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()
        ...
        'Лемешко'
        'Гайворонська'
        'Пустовіт'
        'Ватаманюк'
        'Андрійчук'

  middle_name() → str

    Generate random middle name. :examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.middle_name()
        ...
        'Францівна'
        'Теодорович'
        'Пантелеймонівна'
        'Яремович'
        'Аркадійович'

  middle_name_female() → str

    Generate random female middle name. :examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.middle_name_female()
        ...
        'Юстимівна'
        'Ігорівна'
        'Станіславівна'
        'Єлисеївна'
        'Алевтинівна'

  middle_name_male() → str

    Generate random male middle name. :examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.middle_name_male()
        ...
        'Ярославович'
        'Едуардович'
        'Тарасович'
        'Йосипович'
        'Алевтинович'

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

  Bases: `Provider`

  country_calling_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country_calling_code()
        ...
        '+38061'
        '+38063'
        '+38033'
        '+38050'
        '+38069'

  msisdn() → str

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

    Examples:

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

  phone_number() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.phone_number()
        ...
        '+380 (60) 487-64-75'
        '082 421-94-89'
        '041 157 81 56'
        '+380 93 877-84-08'
        '160-97-53'

## `faker.providers.ssn`

class faker.providers.ssn.uk_UA.Provider(generator: Any)

  Bases: `Provider`

  ssn(birthday: str | None = None, gender: Literal['M', 'F', 'X'] | None = None) → str

    Ukrainian “Реєстраційний номер облікової картки платника податків” also known as “Ідентифікаційний номер фізичної особи”. @params: birthday: “DD-MM-YYYY” format, default random date @params: gender: “M” or “F” default: random gender

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ssn()
        ...
        '4283487617'
        '4377114119'
        '3086262300'
        '3550390218'
        '4253658817'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ssn(birthday='22-06-1990', gender='F')
        ...
        '3304596440'
        '3304549462'
        '3304587607'
        '3304553020'
        '3304514167'