# Locale ru_RU

## `faker.providers.address`

class faker.providers.address.ru_RU.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()
        ...
        'г. Кропоткин (Краснод.), пр. Черемушки, д. 8 стр. 4, 421948'
        'г. Бугульма, наб. Дорожников, д. 656 стр. 88, 840801'
        'д. Сыктывкар, алл. 40 лет Победы, д. 439 к. 92, 115871'
        'клх Гремячинск (Бурят.), наб. Одесская, д. 8 стр. 696, 423209'
        'г. Верхний Уфалей, ш. Мельничное, д. 20 стр. 9/5, 396947'

  administrative_unit() → str
    Examples:

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

  building_number() → str
    Example:

      ‘791’

    Examples:

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

  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()
        ...
        'бург'
        'поль'
        'бург'
        'поль'
        'ск'

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

  current_country_code() → str
    Examples:

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

  postcode() → str
    Example:

      86039-9874

    Examples:

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

  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()
        ...
        'ш. Фадеева, д. 848 к. 5/8'
        'пер. Красноярский, д. 34 к. 994'
        'ш. Братское, д. 2 стр. 957'
        'наб. Блюхера, д. 4'
        'пр. Азина, д. 1 стр. 116'

  street_name() → str
    Example:

      ‘Crist Parks’

    Examples:

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

  street_suffix() → str
    Example:

      ‘Avenue’

    Examples:

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

  street_title() → str
    Examples:

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

## `faker.providers.automotive`

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

  Bases: `Provider`

  Implement automotive provider for `ru_RU` locale.

  Sources:

  - https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Russia

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

  license_plate() → str

    Generate a license plate.

    Examples:

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

  plate_letter() → str

    Generate a letter for license plates.

    Examples:

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

  plate_number() → str

    Generate a number for license plates.

    Examples:

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

  plate_number_extra() → str

    Generate extra numerical code for license plates.

    Examples:

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

  plate_number_special() → str

    Generate a special code for license plates.

    Examples:

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

  plate_suffix() → str

    Generate a suffix code for license plates.

    Examples:

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

  vehicle_category() → str

    Generate a vehicle category code for license plates.

    Examples:

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

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

  Bases: `Provider`

  Implement bank provider for `ru_RU` locale.

  Sources for region codes, currency codes, and bank names:

  - https://ru.wikipedia.org/wiki/Коды_субъектов_Российской_Федерации

  - https://ru.wikipedia.org/wiki/Общероссийский_классификатор_валют

  - http://cbr.ru/credit/coreports/ko17012020.zip

  aba() → str

    Generate an ABA routing transit number.

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

  bban() → str

    Generate a Basic Bank Account Number (BBAN).

    Examples:

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

  bic() → str

    Generate a bank identification code (BIC).

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

    Examples:

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

  checking_account() → str

    Generate a checking account number.

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

    Examples:

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

  correspondent_account() → str

    Generate a correspondent account number.

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

    Examples:

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

  iban() → str

    Generate an International Bank Account Number (IBAN).

    Examples:

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

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

    Generate a SWIFT code.

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

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

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

    Examples:

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

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

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

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

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

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

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

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

    Generate an 11-digit SWIFT code.

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

    Examples:

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

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

  swift8(use_dataset: bool = False) → str

    Generate an 8-digit SWIFT code.

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

    Examples:

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

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

## `faker.providers.color`

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

  Bases: `Provider`

  Implement color provider for `ru_RU` locale.

  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()
        ...
        'lime'
        'белый'
        'lime'
        'черный'
        'пурпурный'

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

  Bases: `Provider`

  bs() → str
    Example:

      ‘integrate extensible convergence’

    Examples:

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

  businesses_inn() → str

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

    Examples:

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

  businesses_ogrn() → str

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

    Examples:

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

  catch_phrase() → str
    Example:

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

    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_prefix() → str
    Example:

      ‘ООО’

    Examples:

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

  company_suffix() → str
    Example:

      ‘Ltd’

    Examples:

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

  individuals_inn() → str

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

    Examples:

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

  individuals_ogrn() → str

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

    Examples:

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

  kpp() → str

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

    Examples:

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

  large_company() → str
    Example:

      ‘АвтоВАЗ’

    Examples:

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

  snils() → str

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

    Examples:

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

## `faker.providers.credit_card`

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

  Bases: `Provider`

  Implement credit card provider for `ru_RU` locale.

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

  Sources:

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

  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 a set of credit card details.

    Examples:

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

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

    Generate a valid credit card number.

    Examples:

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

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

    Generate a credit card provider name.

    Examples:

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

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

    Generate a credit card security code.

    Examples:

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

## `faker.providers.currency`

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

  Bases: `Provider`

  cryptocurrency() → Tuple[str, str]
    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()
        ...
        ('MWK', 'Квача')
        ('NZD', 'Новозеландский доллар')
        ('BAM', 'Конвертируемая марка Боснии и Герцеговины')
        ('IRR', 'Иранский риал')
        ('SPL', 'Луиджино')

  currency_code() → str
    Examples:

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

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

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

  Bases: `Provider`

  am_pm() → str
    Examples:

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

  century() → str
    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)

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date()
        ...
        '2017-04-10'
        '2012-06-07'
        '1993-07-18'
        '1984-06-30'
        '1998-08-16'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date(pattern='%m/%d/%Y')
        ...
        '04/10/2017'
        '06/07/2012'
        '07/18/1993'
        '06/30/1984'
        '08/16/1998'

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

  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 – A `DateParseType`. Defaults to 30 years ago

      - end_date – A `DateParseType`. Defaults to `"today"`

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between()
        ...
        datetime.date(2021, 4, 25)
        datetime.date(2018, 9, 20)
        datetime.date(2008, 8, 6)
        datetime.date(2003, 10, 1)
        datetime.date(2011, 4, 27)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_between(start_date='-1w')
        ...
        datetime.date(2025, 12, 23)
        datetime.date(2025, 12, 23)
        datetime.date(2025, 12, 20)
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 21)

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

  date_between_dates(date_start: date | datetime | timedelta | str | int | None = None, date_end: date | datetime | timedelta | str | int | None = None) → date

    Get a random date between the two given dates.

    Parameters:

      - date_start – A `DateParseType`. Defaults to the UNIX epoch

      - date_end – A `DateParseType`. Defaults to the current date and time

    Examples:

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

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

    Get a date object between January 1, 1970 and now

    Parameters:

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_object()
        ...
        datetime.date(2017, 4, 10)
        datetime.date(2012, 6, 7)
        datetime.date(1993, 7, 18)
        datetime.date(1984, 6, 30)
        datetime.date(1998, 8, 16)

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

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

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

    Parameters:

      - tzinfo – Defaults to None.

      - minimum_age – Defaults to `0`.

      - maximum_age – Defaults to `115`.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_of_birth()
        ...
        datetime.date(2007, 12, 8)
        datetime.date(1997, 11, 26)
        datetime.date(1958, 10, 8)
        datetime.date(1940, 1, 7)
        datetime.date(1969, 4, 16)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_of_birth(minimum_age=30, maximum_age=50)
        ...
        datetime.date(1992, 9, 17)
        datetime.date(1990, 11, 24)
        datetime.date(1983, 10, 24)
        datetime.date(1980, 6, 1)
        datetime.date(1985, 9, 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. Defaults to True

      - after_today – include days in current century after today. Defaults to False

    Examples:

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

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

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

    Gets a Date object for the decade year.

    Parameters:

      - before_today – include days in current decade before today. Defaults to True

      - after_today – include days in current decade after today. Defaults to False

    Examples:

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_decade(before_today=False, after_today=True)
        ...
        datetime.date(2029, 5, 17)
        datetime.date(2029, 1, 10)
        datetime.date(2027, 9, 3)
        datetime.date(2027, 1, 9)
        datetime.date(2028, 1, 14)

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

    Gets a Date object for the current month.

    Parameters:

      - before_today – include days in current month before today. Defaults to True

      - after_today – include days in current month after today. Defaults to False

    Examples:

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_month(before_today=False, after_today=True)
        ...
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 27)
        datetime.date(2025, 12, 26)
        datetime.date(2025, 12, 28)

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

    Gets a Date object for the current year.

    Parameters:

      - before_today – include days in current year before today. Defaults to True

      - after_today – include days in current year after today. Defaults to False

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_year()
        ...
        datetime.date(2025, 10, 30)
        datetime.date(2025, 9, 29)
        datetime.date(2025, 5, 31)
        datetime.date(2025, 4, 3)
        datetime.date(2025, 7, 3)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_this_year(before_today=False, after_today=True)
        ...
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 30)
        datetime.date(2025, 12, 27)
        datetime.date(2025, 12, 26)
        datetime.date(2025, 12, 28)

  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 a specified end_datetime

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time()
        ...
        datetime.datetime(2017, 4, 10, 2, 4, 12, 122199)
        datetime.datetime(2012, 6, 7, 1, 35, 54, 483110)
        datetime.datetime(1993, 7, 18, 12, 33, 12, 891653)
        datetime.datetime(1984, 6, 30, 3, 7, 0, 302937)
        datetime.datetime(1998, 8, 16, 3, 37, 15, 531296)

  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, 0001 and now

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

      - start_datetime – A `DateParseType`. Defaults to UNIX timestamp `-62135596800`,

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_ad()
        ...
        datetime.datetime(1710, 12, 10, 4, 39, 7, 592056)
        datetime.datetime(1535, 11, 6, 1, 42, 8, 366478)
        datetime.datetime(852, 8, 25, 14, 56, 4, 935646)
        datetime.datetime(525, 4, 21, 5, 13, 41, 272789)
        datetime.datetime(1036, 4, 28, 12, 2, 56, 523499)

  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 – A `DateParseType`. Defaults to 30 years ago

      - end_date – A `DateParseType`. Defaults to `"now"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between()
        ...
        datetime.datetime(2021, 4, 25, 12, 39, 15, 236214)
        datetime.datetime(2018, 9, 21, 2, 4, 1, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 42, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 18, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 14, 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

    Get a random datetime between the two given datetimes.

    Parameters:

      - datetime_start – A `DateParseType`. Defaults to the UNIX epoch

      - datetime_end – A `DateParseType`. Defaults to the current date and time

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates()
        ...
        datetime.datetime(2025, 12, 25, 5, 28, 32)
        datetime.datetime(2025, 12, 25, 5, 28, 32)
        datetime.datetime(2025, 12, 25, 5, 28, 32)
        datetime.datetime(2025, 12, 25, 5, 28, 32)
        datetime.datetime(2025, 12, 25, 5, 28, 32)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
        ...
        datetime.datetime(2021, 4, 25, 12, 39, 15, 236214)
        datetime.datetime(2018, 9, 21, 2, 4, 1, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 42, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 18, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 14, 171082)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_between_dates(datetime_start='now', datetime_end='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 29, 441207)
        datetime.datetime(2026, 9, 28, 1, 31, 18, 993625)
        datetime.datetime(2026, 5, 27, 20, 6, 18, 345382)
        datetime.datetime(2026, 3, 29, 19, 4, 39, 534973)
        datetime.datetime(2026, 6, 29, 23, 11, 13, 405703)

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

    Gets a datetime object for the current century.

    Parameters:

      - before_now – include days in current century before today. Defaults to True

      - after_now – include days in current century after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_century()
        ...
        datetime.datetime(2021, 12, 9, 18, 8, 40, 495579)
        datetime.datetime(2019, 9, 11, 3, 50, 42, 126451)
        datetime.datetime(2010, 12, 5, 7, 41, 10, 7121)
        datetime.datetime(2006, 9, 23, 4, 17, 48, 335193)
        datetime.datetime(2013, 4, 14, 2, 43, 48, 187399)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_century(before_now=False, after_now=True)
        ...
        datetime.datetime(2088, 6, 25, 23, 31, 33, 673107)
        datetime.datetime(2082, 1, 31, 8, 27, 36, 496438)
        datetime.datetime(2057, 2, 10, 6, 50, 13, 915627)
        datetime.datetime(2045, 2, 22, 23, 36, 7, 569329)
        datetime.datetime(2063, 10, 29, 10, 9, 58, 518801)

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

    Gets a datetime object for the decade year.

    Parameters:

      - before_now – include days in current decade before today. Defaults to True

      - after_now – include days in current decade after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_decade()
        ...
        datetime.datetime(2025, 1, 19, 6, 6, 20, 61842)
        datetime.datetime(2024, 7, 14, 7, 16, 44, 801873)
        datetime.datetime(2022, 7, 8, 1, 4, 35, 622571)
        datetime.datetime(2021, 7, 19, 19, 0, 43, 554289)
        datetime.datetime(2023, 1, 22, 6, 2, 45, 246159)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_decade(before_now=False, after_now=True)
        ...
        datetime.datetime(2029, 5, 17, 15, 31, 21, 179013)
        datetime.datetime(2029, 1, 10, 17, 34, 29, 490623)
        datetime.datetime(2027, 9, 3, 12, 45, 2, 261995)
        datetime.datetime(2027, 1, 9, 6, 12, 46, 39776)
        datetime.datetime(2028, 1, 14, 15, 54, 25, 292424)

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

    Gets a datetime object for the current month.

    Parameters:

      - before_now – include days in current month before today. Defaults to True

      - after_now – include days in current month after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_month()
        ...
        datetime.datetime(2025, 12, 21, 11, 0, 38, 394860)
        datetime.datetime(2025, 12, 19, 8, 43, 55, 47128)
        datetime.datetime(2025, 12, 11, 4, 33, 7, 537012)
        datetime.datetime(2025, 12, 7, 6, 33, 13, 540389)
        datetime.datetime(2025, 12, 13, 9, 17, 37, 509537)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_month(before_now=False, after_now=True)
        ...
        datetime.datetime(2025, 12, 30, 22, 42, 53, 92265)
        datetime.datetime(2025, 12, 30, 8, 39, 42, 25707)
        datetime.datetime(2025, 12, 28, 1, 49, 43, 385085)
        datetime.datetime(2025, 12, 26, 23, 33, 21, 83596)
        datetime.datetime(2025, 12, 28, 16, 34, 12, 704176)

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

    Gets a datetime object for the current year.

    Parameters:

      - before_now – include days in current year before today. Defaults to True

      - after_now – include days in current year after today. Defaults to False

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_year()
        ...
        datetime.datetime(2025, 10, 30, 11, 53, 46, 417429)
        datetime.datetime(2025, 9, 29, 12, 29, 40, 25418)
        datetime.datetime(2025, 5, 31, 15, 51, 13, 987996)
        datetime.datetime(2025, 4, 3, 18, 1, 49, 553643)
        datetime.datetime(2025, 7, 3, 3, 40, 18, 908904)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.date_time_this_year(before_now=False, after_now=True)
        ...
        datetime.datetime(2025, 12, 30, 22, 42, 53, 92265)
        datetime.datetime(2025, 12, 30, 8, 39, 42, 25707)
        datetime.datetime(2025, 12, 28, 1, 49, 43, 385085)
        datetime.datetime(2025, 12, 26, 23, 33, 21, 83596)
        datetime.datetime(2025, 12, 28, 16, 34, 12, 704176)

  day_of_month() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.day_of_month()
        ...
        '10'
        '07'
        '18'
        '30'
        '16'

  day_of_week() → str
    Examples:

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

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

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

    Parameters:

      - end_date – A `DateParseType`. Defaults to `"+30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_date()
        ...
        datetime.date(2026, 1, 19)
        datetime.date(2026, 1, 16)
        datetime.date(2026, 1, 7)
        datetime.date(2026, 1, 2)
        datetime.date(2026, 1, 9)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_date(end_date='+1y')
        ...
        datetime.date(2026, 10, 29)
        datetime.date(2026, 9, 27)
        datetime.date(2026, 5, 28)
        datetime.date(2026, 3, 30)
        datetime.date(2026, 6, 30)

  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.

    Parameters:

      - end_date – A `DateParseType`. Defaults to `"+30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime()
        ...
        datetime.datetime(2026, 1, 19, 13, 27, 33, 594731)
        datetime.datetime(2026, 1, 16, 23, 12, 10, 54467)
        datetime.datetime(2026, 1, 6, 20, 17, 14, 116942)
        datetime.datetime(2026, 1, 1, 23, 53, 44, 957843)
        datetime.datetime(2026, 1, 9, 13, 35, 36, 566513)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime(end_date='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 29, 596785)
        datetime.datetime(2026, 9, 28, 1, 31, 19, 235670)
        datetime.datetime(2026, 5, 27, 20, 6, 18, 924810)
        datetime.datetime(2026, 3, 29, 19, 4, 40, 276056)
        datetime.datetime(2026, 6, 29, 23, 11, 13, 894428)

  iso8601(tzinfo: tzinfo | None = None, end_datetime: date | datetime | timedelta | str | int | None = None, sep: str = 'T', timespec: str = 'auto') → str

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

    Parameters:

      - tzinfo – timezone, instance of datetime.tzinfo subclass

      - end_datetime – A `DateParseType`. Defaults to the current date and time

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

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iso8601()
        ...
        '2017-04-10T02:04:12.122199'
        '2012-06-07T01:35:54.483110'
        '1993-07-18T12:33:12.891653'
        '1984-06-30T03:07:00.302937'
        '1998-08-16T03:37:15.531296'

  month() → str
    Examples:

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

  month_name() → str
    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.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_date()
        ...
        datetime.date(2025, 12, 19)
        datetime.date(2025, 12, 16)
        datetime.date(2025, 12, 7)
        datetime.date(2025, 12, 2)
        datetime.date(2025, 12, 9)

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

  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.

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - tzinfo – timezone, instance of datetime.tzinfo subclass

    Example:

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.past_datetime()
        ...
        datetime.datetime(2025, 12, 20, 13, 27, 32, 594731)
        datetime.datetime(2025, 12, 17, 23, 12, 9, 54467)
        datetime.datetime(2025, 12, 7, 20, 17, 13, 116942)
        datetime.datetime(2025, 12, 2, 23, 53, 43, 957843)
        datetime.datetime(2025, 12, 10, 13, 35, 35, 566513)

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

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

  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

      - end_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time()
        ...
        '02:04:12'
        '01:35:54'
        '12:33:12'
        '03:07:00'
        '03:37:15'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time(pattern='%I:%M %p')
        ...
        '02:04 AM'
        '01:35 AM'
        '12:33 PM'
        '03:07 AM'
        '03:37 AM'

  time_delta(end_datetime: date | datetime | timedelta | str | int | None = None) → timedelta

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

    Parameters:

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

    Examples:

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

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

  time_object(end_datetime: date | datetime | timedelta | str | int | None = None) → time

    Get a time object

    Parameters:

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

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object()
        ...
        datetime.time(2, 4, 12, 122199)
        datetime.time(1, 35, 54, 483110)
        datetime.time(12, 33, 12, 891653)
        datetime.time(3, 7, 0, 302937)
        datetime.time(3, 37, 15, 531296)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object(end_datetime='+1h')
        ...
        datetime.time(2, 54, 52, 40864)
        datetime.time(2, 21, 23, 118961)
        datetime.time(12, 58, 26, 949344)
        datetime.time(3, 22, 32, 403238)
        datetime.time(4, 7, 56, 120293)

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

    Parameters:

      - start_date – A `DateParseType`. Defaults to `"-30d"`

      - end_date – A `DateParseType`. Defaults to `"now"`

      - precision – A float representing the time interval between data points.

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

    Examples:

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

  timezone() → str
    Examples:

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

  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.

    Parameters:

      - end_datetime – A `DateParseType`. Defaults to the UNIX epoch

      - start_datetime – A `DateParseType`. Defaults to the current date and time

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.unix_time()
        ...
        1491789852.122199
        1339032954.4831102
        742998792.8916534
        457412820.3029369
        903238635.5312959

  year() → str
    Examples:

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

## `faker.providers.internet`

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

  Bases: `Provider`

  ascii_company_email() → str
    Examples:

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

  ascii_email() → str
    Examples:

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

  ascii_free_email() → str
    Examples:

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

  ascii_safe_email() → str
    Examples:

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

  company_email() → str
    Examples:

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

  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.biz'
        'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamo.edu'
        'rsoitciyjatufbjfquyfvudjerivnsrsprechaalfphoqywwursulakiudm.net'
        'ujkyfemsyj.biz'
        'yastipdtwjouhjjorvdtvxkkhdirblaoisavobsvdnhimwbflybiwimdljso.biz'

  domain_name(levels: int = 1) → str

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

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

    Examples:

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

  domain_word() → str
    Examples:

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

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

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

  free_email() → str
    Examples:

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

  free_email_domain() → str
    Examples:

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

  hostname(levels: int = 1) → str

    Produce a hostname with specified number of subdomain levels.

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

    Examples:

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

  http_method() → str

    Returns random HTTP method https://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()
        ...
        'apotapova@example.org'
        'sokrat76@example.com'
        'miron2002@example.org'
        'visheslav_1985@example.org'
        'tverdislav92@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()
        ...
        'edu'
        'info'
        'edu'
        'info'
        'ru'

  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://oao.info/categorylogin.jsp'
        'https://www.kudrjashova.com/main/main/mainprivacy.htm'
        'https://www.npo.org/app/list/searchlogin.html'
        'http://rao.edu/list/searchprivacy.asp'
        'https://www.zao.edu/tag/list/wp-contenthomepage.html'

  uri_extension() → str
    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://ip.net/'
        'https://npo.com/'
        'http://oao.edu/'
        'https://www.rao.edu/'
        'https://medvedev.info/'

  user_name() → str
    Examples:

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

## `faker.providers.job`

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

  Bases: `Provider`

  job() → str
    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.ru_RU.Provider(generator: Any)

  Bases: `Provider`

  Implement lorem provider for `ru_RU` locale.

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

    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Сынок светило вздрагивать лететь забирать. Изучить порт анализ заплакать мера горький устройство тута.', 'Плясать рай роса один предоставить избегать.\nКакой при монета кольцо. Пространство добиться достоинство коробка командующий отдел госпожа. Витрина горький тесно пересечь.', 'Сопровождаться очутиться степь. Слишком вообще покидать. Мелькнуть рабочий призыв темнеть разнообразный четко руководитель.']

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

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

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

    Generate a word.

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

    Examples:

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

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

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

    Generate a tuple of words.

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

    if `word_list` is not provided, the method will use a default value of None, which will result in the method calling the `get_words_list` method to get the word list. If `word_list` is provided, the method will use the provided list.

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

    Examples:

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

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

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

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

## `faker.providers.passport`

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

  Bases: `Provider`

  passport_dob() → date

    Generate a datetime date of birth.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.passport_dob()
        ...
        datetime.date(2007, 12, 8)
        datetime.date(1997, 11, 26)
        datetime.date(1958, 10, 8)
        datetime.date(1940, 1, 7)
        datetime.date(1969, 4, 16)

  passport_number() → str

    Generate a passport number by replacing tokens to be alphanumeric

    Examples:

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

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

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

    Examples:

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

## `faker.providers.person`

class faker.providers.person.ru_RU.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()
        ...
        'Самоанский'
        'Таджикский'
        'Аймарский'
        'Литовский'
        'Идиш'

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

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

  middle_name_female() → str
    Examples:

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

  middle_name_male() → str
    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.ru_RU.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()
        ...
        '8 604 876 47 59'
        '+7 (824) 219-4892'
        '+71157815659'
        '+7 (877) 840-8016'
        '+7 975 351 3933'

## `faker.providers.ssn`

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

  Bases: `Provider`

  ssn() → str
    Examples:

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