# Locale it_IT

## `faker.providers.address`

class faker.providers.address.it_IT.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()
        ...
        "Contrada Tullio, 846 Appartamento 4\n40059, Sant'Antonio (BO)"
        'Strada Borgia, 77\n86040, Monacilioni (CB)'
        'Stretto Gullotta, 8 Piano 0\n51010, Avaglio (PT)'
        'Borgo Antonella, 23 Appartamento 25\n63822, Porto San Giorgio (FM)'
        'Vicolo Allegra, 67 Appartamento 4\n18038, San Bartolomeo (IM)'

  administrative_unit() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.administrative_unit()
        ...
        'Vicenza'
        'Lodi'
        'Trapani'
        'Massa-Carrara'
        'Ascoli Piceno'

  building_number() → str
    Example:

      ‘791’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.building_number()
        ...
        '96'
        '846'
        '4'
        '28'
        '95'

  city() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city()
        ...
        'Gratosoglio'
        'Montalbano Di Fasano'
        'Bossolasco'
        'Bagnoli Di Sopra'
        'Terranova Monferrato'

  city_prefix() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city_prefix()
        ...
        'Quarto'
        'Quarto'
        'San'
        'Sesto'
        'Settimo'

  city_suffix() → str
    Example:

      ‘town’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.city_suffix()
        ...
        'veneto'
        'veneto'
        'a mare'
        'salentino'
        'umbro'

  country() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.country()
        ...
        'Tokelau'
        'India'
        'Sierra Leone'
        'Regno Unito'
        'Giappone'

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

  current_country_code() → str
    Examples:

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

  postcode() → str
    Example:

      86039-9874

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode()
        ...
        '70024'
        '07031'
        '88836'
        '20044'
        '38053'

  postcode_city_province() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.postcode_city_province()
        ...
        '70024, La Murgetta (BA)'
        '88836, Cotronei (KR)'
        '38053, Castello Tesino (TN)'
        '74028, Sava (TA)'
        '58042, Arcille (GR)'

  secondary_address() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.secondary_address()
        ...
        'Piano 6'
        'Appartamento 74'
        'Piano 7'
        'Piano 9'
        'Appartamento 8'

  state() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.state()
        ...
        'Vicenza'
        'Lodi'
        'Trapani'
        'Massa-Carrara'
        'Ascoli Piceno'

  state_abbr() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.state_abbr()
        ...
        'VI'
        'LO'
        'TP'
        'MS'
        'AP'

  street_address() → str
    Example:

      ‘791 Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_address()
        ...
        'Piazza Guidone, 846 Appartamento 4'
        'Stretto Comencini, 81'
        'Incrocio Mercadante, 818'
        'Incrocio Jolanda, 69'
        'Borgo Antonella, 23 Appartamento 25'

  street_name() → str
    Example:

      ‘Crist Parks’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_name()
        ...
        'Incrocio Bartoli'
        'Stretto Speri'
        'Contrada Sinisi'
        'Vicolo Galeati'
        'Contrada Elladio'

  street_suffix() → str
    Example:

      ‘Avenue’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.street_suffix()
        ...
        'Incrocio'
        'Incrocio'
        'Piazza'
        'Contrada'
        'Stretto'

## `faker.providers.automotive`

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

  Bases: `Provider`

  Implement automotive provider for `it_IT` locale.

  Sources:

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

  license_plate() → str

    Generate a license plate.

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.license_plate()
        ...
        'YN876BI'
        'PL824SG'
        'YD489TZ'
        'JD578XC'
        'LN387KT'

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

  Bases: `Provider`

  Implement bank provider for `it_IT` locale.

  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.

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

  bban() → str

    Generate a Basic Bank Account Number (BBAN).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bban()
        ...
        'M6048764759382421948924'
        'D1578156593877840801609'
        'P5351393328711587148418'
        'K8398947196593423209471'
        'C2201868483396947751591'

  iban() → str

    Generate an International Bank Account Number (IBAN).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.iban()
        ...
        'IT25M6048764759382421948924'
        'IT62D1578156593877840801609'
        'IT85P5351393328711587148418'
        'IT70K8398947196593423209471'
        'IT97C2201868483396947751591'

  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()
        ...
        'YNBIIT65ZT4'
        'SGQEITSIGQ8'
        'JDXCITV4'
        'LNKTITN9'
        'OQIBIT9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=8)
        ...
        'MYNBITQ6'
        'PMZJIT4W'
        'SGQEITSI'
        'YDTZITQ8'
        'WZTEITTG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=8, use_dataset=True)
        ...
        'MYNBITQ6'
        'PMZJIT4W'
        'SGQEITSI'
        'YDTZITQ8'
        'WZTEITTG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11)
        ...
        'MYNBITQ65ZT'
        'PLSGIT6ISIG'
        'TZIRITJTGEV'
        'PRDLIT1UN94'
        'OQIBIT9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, primary=True)
        ...
        'MYNBITQ6XXX'
        'PMZJIT4WXXX'
        'SGQEITSIXXX'
        'YDTZITQ8XXX'
        'WZTEITTGXXX'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, use_dataset=True)
        ...
        'MYNBITQ65ZT'
        'PLSGIT6ISIG'
        'TZIRITJTGEV'
        'PRDLIT1UN94'
        'OQIBIT9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift(length=11, primary=True, use_dataset=True)
        ...
        'MYNBITQ6XXX'
        'PMZJIT4WXXX'
        'SGQEITSIXXX'
        'YDTZITQ8XXX'
        'WZTEITTGXXX'

  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()
        ...
        'MYNBITQ65ZT'
        'PLSGIT6ISIG'
        'TZIRITJTGEV'
        'PRDLIT1UN94'
        'OQIBIT9AFZA'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift11(use_dataset=True)
        ...
        'MYNBITQ65ZT'
        'PLSGIT6ISIG'
        'TZIRITJTGEV'
        'PRDLIT1UN94'
        'OQIBIT9AFZA'

  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()
        ...
        'MYNBITQ6'
        'PMZJIT4W'
        'SGQEITSI'
        'YDTZITQ8'
        'WZTEITTG'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.swift8(use_dataset=True)
        ...
        'MYNBITQ6'
        'PMZJIT4W'
        'SGQEITSI'
        'YDTZITQ8'
        'WZTEITTG'

## `faker.providers.company`

class faker.providers.company.it_IT.Provider(generator: Any)

  Bases: `Provider`

  bs() → str
    Example:

      ‘integrate extensible convergence’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.bs()
        ...
        'interfacce exploit front-end'
        'comunità migliorate sinergiche'
        'sistemi strategiche magnetiche'
        'sistemi sinergizzate wireless'
        'tecnologie target strategici'

  catch_phrase() → str
    Example:

      ‘Robust full-range hub’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.catch_phrase()
        ...
        'Conoscenza base switchabile ottima'
        'Analizzatore espansa sistemica'
        'Orchestrazione inversa locale'
        'Sistema aperto innovativa globale'
        'Parallelismo configurabile interattiva'

  company() → str
    Example:

      ‘Acme Ltd’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company()
        ...
        'Puglisi-Bartoli Group'
        'Speri, Pirelli e Marconi s.r.l.'
        'Galeati-Tiepolo e figli'
        'Cilibrasi-Cadorna Group'
        'Comencini, Mastroianni e Calarco SPA'

  company_suffix() → str
    Example:

      ‘Ltd’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_suffix()
        ...
        's.r.l.'
        's.r.l.'
        'SPA'
        'Group'
        's.r.l.'

  company_vat() → str

    Returns Italian VAT identification number (Partita IVA).

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_vat()
        ...
        'IT66048761200'
        'IT47593820377'
        'IT21948920406'
        'IT11578150564'
        'IT59387780345'

## `faker.providers.currency`

class faker.providers.currency.it_IT.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', 'Malawian kwacha')
        ('NZD', 'New Zealand dollar')
        ('BAM', 'Bosnia and Herzegovina convertible mark')
        ('IRR', 'Iranian rial')
        ('SPL', 'Seborga luigino')

  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()
        ...
        'Malawian kwacha'
        'New Zealand dollar'
        'Bosnia and Herzegovina convertible mark'
        'Iranian rial'
        'Seborga luigino'

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

      $

    Examples:

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

  pricetag()
    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.it_IT.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, 4, 522402)
        datetime.datetime(2012, 6, 7, 1, 35, 47, 661521)
        datetime.datetime(1993, 7, 18, 12, 33, 9, 106509)
        datetime.datetime(1984, 6, 30, 3, 6, 57, 972686)
        datetime.datetime(1998, 8, 16, 3, 37, 10, 929823)

  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, 38, 59, 992256)
        datetime.datetime(1535, 11, 6, 1, 42, 1, 544891)
        datetime.datetime(852, 8, 25, 14, 56, 1, 150505)
        datetime.datetime(525, 4, 21, 5, 13, 38, 942535)
        datetime.datetime(1036, 4, 28, 12, 2, 51, 922028)

  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, 6, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 52, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 33, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 9, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 5, 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, 23)
        datetime.datetime(2025, 12, 25, 5, 28, 23)
        datetime.datetime(2025, 12, 25, 5, 28, 23)
        datetime.datetime(2025, 12, 25, 5, 28, 23)
        datetime.datetime(2025, 12, 25, 5, 28, 23)

        >>> 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, 6, 236214)
        datetime.datetime(2018, 9, 21, 2, 3, 52, 808743)
        datetime.datetime(2008, 8, 7, 7, 33, 33, 361449)
        datetime.datetime(2003, 10, 2, 0, 44, 9, 49189)
        datetime.datetime(2011, 4, 28, 4, 1, 5, 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, 20, 441207)
        datetime.datetime(2026, 9, 28, 1, 31, 9, 993625)
        datetime.datetime(2026, 5, 27, 20, 6, 9, 345382)
        datetime.datetime(2026, 3, 29, 19, 4, 30, 534973)
        datetime.datetime(2026, 6, 29, 23, 11, 4, 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, 32, 895782)
        datetime.datetime(2019, 9, 11, 3, 50, 35, 304861)
        datetime.datetime(2010, 12, 5, 7, 41, 6, 221977)
        datetime.datetime(2006, 9, 23, 4, 17, 46, 4942)
        datetime.datetime(2013, 4, 14, 2, 43, 43, 585927)

        >>> 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, 32, 272903)
        datetime.datetime(2082, 1, 31, 8, 27, 34, 318028)
        datetime.datetime(2057, 2, 10, 6, 50, 8, 700770)
        datetime.datetime(2045, 2, 22, 23, 36, 0, 899580)
        datetime.datetime(2063, 10, 29, 10, 9, 54, 120274)

  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, 12, 462045)
        datetime.datetime(2024, 7, 14, 7, 16, 37, 980283)
        datetime.datetime(2022, 7, 8, 1, 4, 31, 837427)
        datetime.datetime(2021, 7, 19, 19, 0, 41, 224038)
        datetime.datetime(2023, 1, 22, 6, 2, 40, 644686)

        >>> 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, 19, 778809)
        datetime.datetime(2029, 1, 10, 17, 34, 27, 312213)
        datetime.datetime(2027, 9, 3, 12, 44, 57, 47139)
        datetime.datetime(2027, 1, 9, 6, 12, 39, 370027)
        datetime.datetime(2028, 1, 14, 15, 54, 20, 893897)

  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, 30, 795063)
        datetime.datetime(2025, 12, 19, 8, 43, 48, 225538)
        datetime.datetime(2025, 12, 11, 4, 33, 3, 751868)
        datetime.datetime(2025, 12, 7, 6, 33, 11, 210139)
        datetime.datetime(2025, 12, 13, 9, 17, 32, 908065)

        >>> 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, 51, 692062)
        datetime.datetime(2025, 12, 30, 8, 39, 39, 847297)
        datetime.datetime(2025, 12, 28, 1, 49, 38, 170229)
        datetime.datetime(2025, 12, 26, 23, 33, 14, 413846)
        datetime.datetime(2025, 12, 28, 16, 34, 8, 305649)

  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, 38, 817632)
        datetime.datetime(2025, 9, 29, 12, 29, 33, 203828)
        datetime.datetime(2025, 5, 31, 15, 51, 10, 202852)
        datetime.datetime(2025, 4, 3, 18, 1, 47, 223393)
        datetime.datetime(2025, 7, 3, 3, 40, 14, 307432)

        >>> 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, 51, 692062)
        datetime.datetime(2025, 12, 30, 8, 39, 39, 847297)
        datetime.datetime(2025, 12, 28, 1, 49, 38, 170229)
        datetime.datetime(2025, 12, 26, 23, 33, 14, 413846)
        datetime.datetime(2025, 12, 28, 16, 34, 8, 305649)

  day_of_month() → str
    Examples:

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

  day_of_week()
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.day_of_week()
        ...
        'lunedì'
        'giovedì'
        'domenica'
        'sabato'
        'domenica'

  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, 24, 594731)
        datetime.datetime(2026, 1, 16, 23, 12, 1, 54467)
        datetime.datetime(2026, 1, 6, 20, 17, 5, 116942)
        datetime.datetime(2026, 1, 1, 23, 53, 35, 957843)
        datetime.datetime(2026, 1, 9, 13, 35, 27, 566513)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.future_datetime(end_date='+1y')
        ...
        datetime.datetime(2026, 10, 29, 15, 28, 20, 596785)
        datetime.datetime(2026, 9, 28, 1, 31, 10, 235670)
        datetime.datetime(2026, 5, 27, 20, 6, 9, 924810)
        datetime.datetime(2026, 3, 29, 19, 4, 31, 276056)
        datetime.datetime(2026, 6, 29, 23, 11, 4, 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:04.522402'
        '2012-06-07T01:35:47.661521'
        '1993-07-18T12:33:09.106509'
        '1984-06-30T03:06:57.972686'
        '1998-08-16T03:37:10.929823'

  month() → str
    Examples:

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

  month_name()
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.month_name()
        ...
        'aprile'
        'giugno'
        'luglio'
        'giugno'
        'agosto'

  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, 23, 594731)
        datetime.datetime(2025, 12, 17, 23, 12, 0, 54467)
        datetime.datetime(2025, 12, 7, 20, 17, 4, 116942)
        datetime.datetime(2025, 12, 2, 23, 53, 34, 957843)
        datetime.datetime(2025, 12, 10, 13, 35, 26, 566513)

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

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

    Examples:

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

  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:04'
        '01:35:47'
        '12:33:09'
        '03:06:57'
        '03:37:10'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time(pattern='%I:%M %p')
        ...
        '02:04 AM'
        '01:35 AM'
        '12:33 PM'
        '03:06 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, 4, 522402)
        datetime.time(1, 35, 47, 661521)
        datetime.time(12, 33, 9, 106509)
        datetime.time(3, 6, 57, 972686)
        datetime.time(3, 37, 10, 929823)

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.time_object(end_datetime='+1h')
        ...
        datetime.time(2, 54, 44, 441068)
        datetime.time(2, 21, 16, 297371)
        datetime.time(12, 58, 23, 164200)
        datetime.time(3, 22, 30, 72987)
        datetime.time(4, 7, 51, 518820)

  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 0x7d660641fe20>
        <generator object Provider.time_series at 0x7d660641fe20>
        <generator object Provider.time_series at 0x7d660641fe20>
        <generator object Provider.time_series at 0x7d660641fe20>
        <generator object Provider.time_series at 0x7d660641fe20>

  timezone() → str
    Examples:

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

  unix_time(end_datetime: date | datetime | timedelta | str | int | None = None, start_datetime: date | datetime | timedelta | str | int | None = None) → float

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

    On Windows, the decimal part is always 0.

    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()
        ...
        1491789844.5224023
        1339032947.6615207
        742998789.1065092
        457412817.9726862
        903238630.9298234

  year() → str
    Examples:

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

## `faker.providers.internet`

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

  Bases: `Provider`

  ascii_company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_company_email()
        ...
        'cpuglisi@tornatore-speri.org'
        'lodescalchi@tiepolo.org'
        'margheritacadorna@gregori.com'
        'montalcinisabatino@callegaro.it'
        'amandasinisi@tremonti-gullotta.it'

  ascii_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_email()
        ...
        'qbartoli@hotmail.com'
        'emarconi@gmail.com'
        'ignaziocilibrasi@gregori.org'
        'montalcinisabatino@callegaro.it'
        'hrubbia@blasi-vespucci.com'

  ascii_free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_free_email()
        ...
        'cpuglisi@fastwebnet.it'
        'ypirelli@vodafone.it'
        'lodescalchi@virgilio.it'
        'ignaziocilibrasi@tim.it'
        'vito92@vodafone.it'

  ascii_safe_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ascii_safe_email()
        ...
        'cpuglisi@example.com'
        'ypirelli@example.com'
        'lodescalchi@example.org'
        'ignaziocilibrasi@example.org'
        'vito92@example.com'

  company_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.company_email()
        ...
        'cpuglisi@tornatore-speri.org'
        'lodescalchi@tiepolo.org'
        'margheritacadorna@gregori.com'
        'montalcinisabatino@callegaro.it'
        'amandasinisi@tremonti-gullotta.it'

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

  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()
        ...
        'puglisi-bartoli.it'
        'pirelli-marconi.eu'
        'galeati.com'
        'gregori.org'
        'borgia.it'

  domain_word() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.domain_word()
        ...
        'puglisi-bartoli'
        'speri'
        'galeati-tiepolo'
        'cilibrasi-cadorna'
        'comencini'

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

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.email()
        ...
        'cpuglisi@example.com'
        'ypirelli@example.com'
        'lodescalchi@example.org'
        'ignaziocilibrasi@example.org'
        'vito92@example.com'

  free_email() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email()
        ...
        'cpuglisi@fastwebnet.it'
        'ypirelli@vodafone.it'
        'lodescalchi@virgilio.it'
        'ignaziocilibrasi@tim.it'
        'vito92@vodafone.it'

  free_email_domain() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.free_email_domain()
        ...
        'gmail.com'
        'gmail.com'
        'libero.it'
        'fastwebnet.it'
        'hotmail.com'

  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.guidone.it'
        'web-47.galeati-tiepolo.org'
        'srv-19.tutino-comencini.com'
        'email-15.zacco-callegaro.it'
        'desktop-93.sinisi.com'

  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()
        ...
        'cpuglisi@example.com'
        'ypirelli@example.com'
        'lodescalchi@example.org'
        'ignaziocilibrasi@example.org'
        'vito92@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()
        ...
        'it'
        'it'
        'com'
        'org'
        'it'

  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://marconi-sinisi.it/categorylogin.jsp'
        'http://www.comencini.eu/main/mainprivacy.htm'
        'https://www.rubbia-tremonti.com/tag/tagsmain.asp'
        'http://www.taccola.com/list/blog/postsabout.html'
        'http://www.burcardo-botticelli.it/wp-contentprivacy.asp'

  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://guidone.it/'
        'https://galeati-tiepolo.org/'
        'http://www.gregori.com/'
        'http://zacco-callegaro.it/'
        'https://www.sinisi.com/'

  user_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.user_name()
        ...
        'cpuglisi'
        'tullio76'
        'sandro59'
        'tonicilea'
        'elladio19'

## `faker.providers.lorem`

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

  Bases: `Provider`

  Implement lorem provider for `it_IT` locale.

  Word list is based on the source(s) below, and some words have been removed to make the word list appropriate for public testing.

  Sources:

  - https://github.com/napolux/paroleitaliane

  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)
        ...
        'Anima vecchio magari temere serio venire. Oh svolgere medio duro ricevere passato. Voglia montagna pronto padre chilometro. Quello su presente lira. Forza faccia però corrente.'
        'Inverno militare assistere temere teatro bastare signorina. Abbandonare maniera speciale difficile fenomeno speranza consiglio notte. Scherzare chiamare nascondere bambino voltare. Zio male esercito elevare capitare figlia tentare. Vasto padrone operaio isola organizzare. Facile difesa confronto seguito ammazzare visita.'
        'Attesa preferire casa ci andare avanzare produrre. Presentare significare minuto minimo destino creare pregare. Oggetto lanciare politico vuoto tecnico saltare. Felice caldo operaio figurare.'
        'Affatto domenica proporre gesto compagno. Sedere bianco chiesa processo anzi o. Padre attorno capitare consentire serio campo base. Anche albergo valere congresso.'
        'Costa scegliere trasformare albero iniziare biondo distinguere. Atto esercito interessare assai libertà. Biondo voi contro freddo questo signora temere compagnia.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.paragraph(nb_sentences=5, variable_nb_sentences=False)
        ...
        'Ricordare indietro distanza merito gusto rivolgere. Venire freddo straniero cristiano certamente. Ricevere passato dire tacere. Sud estendere quello su presente lira bianco intenzione. Però corrente nemico inverno militare assistere temere teatro.'
        'Qua grigio sentimento posare. Parlare sereno figlio. Promettere assoluto tecnico cultura scherzare chiamare. Italiano avanzare fantasia mente tra brutto necessità. Nazione secondo muro vasto.'
        'Nazionale egli base sbagliare facile difesa confronto seguito. Parola poesia luce. Preferire casa ci andare. Stupido termine musica godere. Dottore scusare sognare strumento opporre uguale oggetto.'
        'Mangiare pesare produzione viso fratello felice caldo. Perché situazione differenza questo camera cucina salutare figlia. Bianco chiesa processo anzi. Pericolo trasformare padre attorno capitare consentire serio. Godere genere vino anche.'
        'Contenere verità puro. Costa scegliere trasformare albero iniziare biondo distinguere. Atto esercito interessare assai libertà. Biondo voi contro freddo questo signora temere compagnia. Vendere ascoltare pranzo situazione fiore.'

        >>> 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)
        ...
        ['Anima vecchio magari temere serio venire. Oh svolgere medio duro ricevere passato. Voglia montagna pronto padre chilometro.', 'Su presente lira bianco. Faccia però corrente nemico inverno militare.', 'Teatro bastare signorina prova rivoluzione pelle parlare. Difficile fenomeno speranza consiglio notte di.', 'Italiano avanzare fantasia mente tra brutto necessità. Nazione secondo muro vasto.', 'Operaio isola organizzare giudizio occhio elettrico conservare. Ammazzare visita distinguere attesa. Sposare terreno sinistro stupido. Presentare significare minuto minimo destino creare pregare.']
        ['Dottore mangiare pesare produzione viso fratello felice caldo. Perché situazione differenza questo camera cucina salutare figlia. Bianco chiesa processo anzi.', 'Padre attorno capitare consentire serio campo base. Anche albergo valere congresso. Lungo quanto assai pregare.', 'Passo sicurezza attimo atto esercito interessare. Medico angolo biondo voi. Distinguere superare linea sud nulla.', 'Rosso classe coloro molto. Origine inverno comprendere lira.', 'Spiegare tedesco piazza giusto poeta circa primo. Reale film apparire durare dietro unico forte. Potenza opporre straniero solo cattivo.']
        ['Rendere serie avanzare ordine prodotto collo. Persona giornata spingere nudo importare.', 'Incontrare ponte appartenere isola distanza ciò moderno. Svolgere paese a angolo ferire significare appunto. Consentire zona perfino avvertire qualsiasi voce.', 'Faccia costruire pure abbastanza semplice modo. Considerare papà contrario esistere. Bianco solo greco avere.', 'Scappare cambiare discutere piuttosto segno piano caldo. Dubbio aggiungere animale prendere.', 'Uccidere tratto tacere animo rendere professore. Provocare suo però gettare motivo cortile operaio. Cercare domenica finalmente.']
        ['Finché passo animale colpo. Elemento grave ne entrare luna dietro appena concetto. Quasi esperienza sicurezza escludere brutto non lì.', 'Capitare cambiare massa ancora figurare presto. Tempo pensare giocare vestito. Atteggiamento avvocato repubblica assai.', 'Grande migliore labbro malattia.', 'Infatti gatto voi distruggere ritornare. Contadino caldo sembrare solito altro mio. Campagna gridare corso animo ufficiale. Peccato bosco legge frutto sera.', 'Vista chiudere idea pregare stabilire mantenere tecnico favore. Zio pericoloso spiegare nascondere tono accordo proporre.']
        ['Ampio chiudere discutere rivolgere sinistro oh. Atteggiamento avvocato specie angolo dare animale affare. Fianco colore chiudere poesia vento medio successo.', 'O preferire scomparire. Volgere relazione superiore corsa morte ospedale sentire ma. Pane descrivere sotto aiutare stasera rappresentare.', 'Numero figlia maniera dito sentire rispondere giudicare. Assistere pesare caratteristico egli serio arrivare.', 'In mandare sostenere punto potenza cielo voce.', 'Parlare giungere appartenere. Ritorno aiutare ospedale cattivo fede produzione piazza. Giro ritenere mamma stampa parere.']

        >>> 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)
        ...
        'Ricordare indietro distanza merito gusto rivolgere esperienza luce oh svolgere.'
        'Certamente certo battere scappare voglia montagna pronto padre chilometro bere attorno sogno.'
        'Lira bianco intenzione parete tardi vendere lui sotto distruggere scomparire.'
        'Teatro bastare signorina prova rivoluzione pelle parlare sereno figlio questione promettere assoluto tecnico.'
        'Di venire scherzare italiano avanzare fantasia mente tra.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentence(nb_words=10, variable_nb_words=False)
        ...
        'Sistema ricordare indietro distanza merito gusto rivolgere esperienza luce oh.'
        'Svolgere medio duro ricevere passato dire tacere vista scrivere sud.'
        'Estendere quello su presente lira bianco intenzione parete tardi vendere.'
        'Lui sotto distruggere scomparire ne adesso qua grigio sentimento posare.'
        'Abbandonare maniera speciale difficile fenomeno speranza consiglio notte di venire.'

        >>> 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()
        ...
        ['Ricordare indietro distanza merito gusto rivolgere.', 'Venire freddo straniero cristiano certamente.', 'Ricevere passato dire tacere.']
        ['Sud estendere quello su presente lira bianco intenzione.', 'Però corrente nemico inverno militare assistere temere teatro.', 'Qua grigio sentimento posare.']
        ['Parlare sereno figlio.', 'Promettere assoluto tecnico cultura scherzare chiamare.', 'Italiano avanzare fantasia mente tra brutto necessità.']
        ['Nazione secondo muro vasto.', 'Nazionale egli base sbagliare facile difesa confronto seguito.', 'Parola poesia luce.']
        ['Preferire casa ci andare.', 'Stupido termine musica godere.', 'Dottore scusare sognare strumento opporre uguale oggetto.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.sentences(nb=5)
        ...
        ['Ricordare indietro distanza merito gusto rivolgere.', 'Venire freddo straniero cristiano certamente.', 'Ricevere passato dire tacere.', 'Sud estendere quello su presente lira bianco intenzione.', 'Però corrente nemico inverno militare assistere temere teatro.']
        ['Qua grigio sentimento posare.', 'Parlare sereno figlio.', 'Promettere assoluto tecnico cultura scherzare chiamare.', 'Italiano avanzare fantasia mente tra brutto necessità.', 'Nazione secondo muro vasto.']
        ['Nazionale egli base sbagliare facile difesa confronto seguito.', 'Parola poesia luce.', 'Preferire casa ci andare.', 'Stupido termine musica godere.', 'Dottore scusare sognare strumento opporre uguale oggetto.']
        ['Mangiare pesare produzione viso fratello felice caldo.', 'Perché situazione differenza questo camera cucina salutare figlia.', 'Bianco chiesa processo anzi.', 'Pericolo trasformare padre attorno capitare consentire serio.', 'Godere genere vino anche.']
        ['Contenere verità puro.', 'Costa scegliere trasformare albero iniziare biondo distinguere.', 'Atto esercito interessare assai libertà.', 'Biondo voi contro freddo questo signora temere compagnia.', 'Vendere ascoltare pranzo situazione fiore.']

        >>> 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)
        ...
        'Pregare realtà.'
        'Legare suo.'
        'Pubblico morte.'
        'Perfetto giugno.'
        'Dimenticare massa.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(max_nb_chars=80)
        ...
        'Ricordare indietro distanza merito gusto rivolgere.'
        'Ricevere passato dire tacere.'
        'Però corrente nemico inverno militare assistere temere teatro.'
        'Parlare sereno figlio. Promettere assoluto tecnico cultura scherzare chiamare.'
        'Nazione secondo muro vasto.'

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.text(max_nb_chars=160)
        ...
        'Anima vecchio magari temere serio venire. Oh svolgere medio duro ricevere passato. Voglia montagna pronto padre chilometro.'
        'Teatro bastare signorina prova rivoluzione pelle parlare. Difficile fenomeno speranza consiglio notte di.'
        'Dottore mangiare pesare produzione viso fratello felice caldo. Perché situazione differenza questo camera cucina salutare figlia. Bianco chiesa processo anzi.'
        'Passo sicurezza attimo atto esercito interessare. Medico angolo biondo voi. Distinguere superare linea sud nulla.'
        'Spiegare tedesco piazza giusto poeta circa primo. Reale film apparire durare dietro unico forte. Potenza opporre straniero solo cattivo.'

        >>> 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)
        ...
        ['Anima vecchio magari temere serio venire. Oh svolgere medio duro ricevere passato. Voglia montagna pronto padre chilometro.\nSu presente lira bianco. Faccia però corrente nemico inverno militare.', 'Italiano avanzare fantasia mente tra brutto necessità. Nazione secondo muro vasto.', 'Dottore mangiare pesare produzione viso fratello felice caldo. Perché situazione differenza questo camera cucina salutare figlia. Bianco chiesa processo anzi.', 'Passo sicurezza attimo atto esercito interessare. Medico angolo biondo voi. Distinguere superare linea sud nulla.\nRosso classe coloro molto. Origine inverno comprendere lira.', 'Rendere serie avanzare ordine prodotto collo. Persona giornata spingere nudo importare.']
        ['Faccia costruire pure abbastanza semplice modo. Considerare papà contrario esistere. Bianco solo greco avere.', 'Uccidere tratto tacere animo rendere professore. Provocare suo però gettare motivo cortile operaio. Cercare domenica finalmente.', 'Capitare cambiare massa ancora figurare presto. Tempo pensare giocare vestito. Atteggiamento avvocato repubblica assai.\nGrande migliore labbro malattia.', 'Vista chiudere idea pregare stabilire mantenere tecnico favore. Zio pericoloso spiegare nascondere tono accordo proporre.', 'O preferire scomparire. Volgere relazione superiore corsa morte ospedale sentire ma. Pane descrivere sotto aiutare stasera rappresentare.']
        ['In mandare sostenere punto potenza cielo voce.\nParlare giungere appartenere. Ritorno aiutare ospedale cattivo fede produzione piazza. Giro ritenere mamma stampa parere.', 'Uomo sud anima discorso. Tuttavia portare nuovo. Dedicare ritenere stasera pensare mattino. Indietro esprimere caffè inizio notizia termine trascinare.', 'Attimo straordinario cortile corrente potenza tratto. Religioso entrare prezzo tra.\nConoscere cadere fiume uso. Altro cortile figurare valere.', 'Indicare apparire cattivo aiutare autore attore. Escludere improvviso testa oppure errore fra.\nPerfino permettere moglie gioco accogliere valle. Inutile gesto un bambino conoscenza bruciare.', 'Lettera cristiano calcio villa esercito parecchio inglese restare. Preciso ridere dentro riempire. Perfetto albergo domani posare a.']
        ['Coscienza braccio uno natura reale suonare dunque inverno. Per ciò procedere giovanotto oppure certamente posare. Perfetto realtà crisi male mattina mangiare.', 'Accendere animale patria zona spesso produrre. Che né consiglio intenzione punta.\nFianco pianura presto chissà. Minuto caro tagliare io. Innamorare mandare quello salvare intero corpo.', 'Errore azzurro specie restare risolvere stanza imporre armare. Porta piazza nazionale raccogliere insistere latte diritto.', 'Discorso minimo considerare avanti speranza folla. Diretto quasi esercito metà giudizio. Fissare provocare antico tranquillo atto lei qualità.\nVilla lei campagna avere bere riguardare.', 'Provare ritornare mestiere letto pericolo. Dente campagna rivelare bere quindi. Crisi stagione zia accendere morte.']
        ['Futuro pericoloso scusare sposare civile comunque. Celebrare corsa tavolo marito. Desiderio cattivo desiderare giudizio papà.', 'Paese programma sembrare roba. Tuo cosa fabbrica relazione dipendere sostenere.\nFiume colpa affermare o ascoltare. Cielo albergo pensiero allontanare anzi dare piuttosto attendere.', 'Strada morale scomparire vino pronto ricordo.\nImmagine giù abitare cercare. Signorina produrre avanti determinare sereno comunicazione uccidere. Realtà signora nord pure.', 'Rispondere numero divenire. Lavorare qualche guidare. Argomento donna vostro dirigere prendere programma titolo.', 'Smettere seguire ombra argomento civiltà fiume. Pelle favore rivelare ottenere voglia.\nNudo invece finire accompagnare.']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.texts(nb_texts=5, max_nb_chars=50)
        ...
        ['Venire freddo straniero cristiano certamente.', 'Qua grigio sentimento posare.', 'Nazione secondo muro vasto.', 'Parola poesia luce. Preferire casa ci andare.', 'Bianco chiesa processo anzi.']
        ['Godere genere vino anche. Contenere verità puro.', 'Atto esercito interessare assai libertà.', 'Vendere ascoltare pranzo situazione fiore.', 'Spiegare tedesco piazza giusto poeta circa primo.', 'Potenza opporre straniero solo cattivo.']
        ['Collo cuore italiano provare potenza spiegare.', 'Cominciare assumere professore.', 'Voce guardia preferire faccia.', 'Campagna piccolo spettacolo durante villa.', 'Dubbio aggiungere animale prendere.']
        ['Cercare domenica finalmente.', 'Fronte volare carta caldo questione.', 'Guerra ferro impossibile bestia sì.', 'Atteggiamento avvocato repubblica assai.', 'Insomma freddo assumere sostenere.']
        ['Marito discutere pesare zia.', 'Voi vista chiudere idea.', 'Nascondere tono accordo proporre relazione.', 'Affare sino fianco colore chiudere.', 'Memoria diritto atteggiamento sorgere tu.']

        >>> 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()
        ...
        'pregare'
        'realtà'
        'attività'
        'legare'
        'suo'

        >>> 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()
        ...
        ['sistema', 'ricordare', 'indietro']
        ['distanza', 'merito', 'gusto']
        ['rivolgere', 'esperienza', 'luce']
        ['oh', 'svolgere', 'medio']
        ['duro', 'ricevere', 'passato']

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.words(nb=5)
        ...
        ['sistema', 'ricordare', 'indietro', 'distanza', 'merito']
        ['gusto', 'rivolgere', 'esperienza', 'luce', 'oh']
        ['svolgere', 'medio', 'duro', 'ricevere', 'passato']
        ['dire', 'tacere', 'vista', 'scrivere', 'sud']
        ['estendere', 'quello', 'su', 'presente', 'lira']

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

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

## `faker.providers.person`

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

  Bases: `Provider`

  first_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name()
        ...
        'Rosina'
        'Orlando'
        'Maria'
        'Veronica'
        'Pierpaolo'

  first_name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_female()
        ...
        'Lilla'
        'Lucrezia'
        'Angelina'
        'Gabriella'
        'Monica'

  first_name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_male()
        ...
        'Orlando'
        'Pierpaolo'
        'Annibale'
        'Giuliano'
        'Tullio'

  first_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.first_name_nonbinary()
        ...
        'Rosina'
        'Orlando'
        'Maria'
        'Veronica'
        'Pierpaolo'

  language_name() → str

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

    Examples:

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

  last_name() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name()
        ...
        'Pavanello'
        'Puglisi'
        'Bartoli'
        'Guidone'
        'Tornatore'

  last_name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_female()
        ...
        'Pavanello'
        'Puglisi'
        'Bartoli'
        'Guidone'
        'Tornatore'

  last_name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_male()
        ...
        'Pavanello'
        'Puglisi'
        'Bartoli'
        'Guidone'
        'Tornatore'

  last_name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.last_name_nonbinary()
        ...
        'Pavanello'
        'Puglisi'
        'Bartoli'
        'Guidone'
        'Tornatore'

  name() → str
    Example:

      ‘John Doe’

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name()
        ...
        'Lucrezia Bartoli'
        'Tullio Speri-Pirelli'
        'Sandro Odescalchi-Galeati'
        'Claudia Lombardo'
        'Cesare Gregori'

  name_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name_female()
        ...
        'Lucrezia Bartoli'
        'Monica Speri'
        'Giuseppina Sinisi'
        'Ramona Galeati'
        'Claudia Lombardo-Cilibrasi'

  name_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name_male()
        ...
        'Pierpaolo Bartoli'
        'Tullio Speri'
        'Leopoldo Sinisi'
        'Gian Tiepolo'
        'Ignazio Cilibrasi'

  name_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.name_nonbinary()
        ...
        'Lucrezia Bartoli'
        'Tullio Speri-Pirelli'
        'Sandro Odescalchi-Galeati'
        'Claudia Lombardo'
        'Cesare Gregori'

  prefix() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix()
        ...
        'Sig.'
        'Sig.'
        'Dott.'
        'Sig.'
        'Sig.ra'

  prefix_female() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix_female()
        ...
        'Sig.ra'
        'Sig.ra'
        'Dott.'
        'Sig.ra'
        'Sig.ra'

  prefix_male() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix_male()
        ...
        'Sig.'
        'Sig.'
        'Dott.'
        'Sig.'
        'Sig.'

  prefix_nonbinary() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.prefix_nonbinary()
        ...
        'Sig.'
        'Sig.'
        'Dott.'
        'Sig.'
        'Sig.ra'

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

  Bases: `Provider`

  area_code() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.area_code()
        ...
        '3534'
        '0716'
        '0163'
        '0521'
        '3779'

  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()
        ...
        '32060487679'
        '+39 0865242198'
        '03311578169'
        '+39 377987784'
        '+39 3416097531'

## `faker.providers.ssn`

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

  Bases: `Provider`

  Generates italian fiscal codes.

  static is_leap_year(year: int) → bool

    Checks if the one given is a leap year

  ssn() → str
    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.ssn()
        ...
        'PGLNNL33P56E360E'
        'SNSMCL74D57B499Z'
        'CLBCSR79E70F725X'
        'MSTBTN93B28H363U'
        'SRLCRI45L51G543A'

  vat_id() → str

    http://ec.europa.eu/taxation_customs/vies/faq.html#item_11 :return: A random Italian VAT ID

    Examples:

        >>> Faker.seed(0)
        >>> for _ in range(5):
        ...     fake.vat_id()
        ...
        'IT60487647593'
        'IT42194892411'
        'IT78156593877'
        'IT08016097535'
        'IT39332871158'