Locale it_IT¶

`faker.providers.address`¶

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

Bases: faker.providers.address.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¶

Example:	‘Sashabury’
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.city()
...
'Lamole'
'Schluderns'
"Sant'Elia"
'Agelli'
'Negrisia'

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'

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: faker.providers.automotive.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'

`faker.providers.bank`¶

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

Bases: faker.providers.bank.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_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: Optional[int] = 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: faker.providers.company.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: faker.providers.currency.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: Optional[str] = None) → str¶

Example:	$
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.currency_symbol()
...
'$'
'₨'
'$'
'₹'
'£'

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: faker.providers.date_time.Provider

am_pm() → str¶

Examples:

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

century() → str¶

Example:	‘XVII’
Examples:

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

date(pattern: str = '%Y-%m-%d', end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str¶

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

Parameters:	pattern – Format of the date (year-month-day by default)
Example:	‘2008-11-27’
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date()
...
'1996-03-20'
'2021-07-31'
'1998-08-15'
'1972-10-03'
'1987-08-15'

date_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'today') → datetime.date¶

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

Parameters:	start_date – Defaults to 30 years ago end_date – Defaults to “today”
Example:	Date(‘1999-02-02’)
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2021, 12, 14)
datetime.date(2006, 4, 30)
datetime.date(2019, 1, 4)
datetime.date(2007, 7, 13)
datetime.date(1994, 8, 7)

date_between_dates(date_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, date_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.date¶

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

Parameters:	date_start – Date date_end – Date
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between_dates()
...
datetime.date(2023, 3, 23)
datetime.date(2023, 3, 23)
datetime.date(2023, 3, 23)
datetime.date(2023, 3, 23)
datetime.date(2023, 3, 23)

date_object(end_datetime: Optional[datetime.datetime] = None) → datetime.date¶

Get a date object between January 1, 1970 and now :example: datetime.date(2016, 9, 20)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_object()
...
datetime.date(1996, 3, 20)
datetime.date(2021, 7, 31)
datetime.date(1998, 8, 15)
datetime.date(1972, 10, 3)
datetime.date(1987, 8, 15)

date_of_birth(tzinfo: Optional[datetime.tzinfo] = None, minimum_age: int = 0, maximum_age: int = 115) → datetime.date¶

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

Parameters:	tzinfo – Defaults to None. minimum_age – Defaults to 0. maximum_age – Defaults to 115.
Example:	Date(‘1979-02-02’)
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_of_birth()
...
datetime.date(2022, 2, 23)
datetime.date(1959, 8, 27)
datetime.date(2010, 5, 19)
datetime.date(1964, 6, 17)
datetime.date(1912, 9, 24)

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

Gets a Date object for the current century.

Parameters:	before_today – include days in current century before today after_today – include days in current century after today
Example:	Date(‘2012-04-04’)
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_century()
...
datetime.date(2013, 2, 8)
datetime.date(2014, 4, 23)
datetime.date(2001, 5, 18)
datetime.date(2008, 10, 22)
datetime.date(2017, 5, 24)

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

Gets a Date object for the decade year.

Parameters:	before_today – include days in current decade before today after_today – include days in current decade after today
Example:	Date(‘2012-04-04’)
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_decade()
...
datetime.date(2021, 8, 21)
datetime.date(2021, 10, 15)
datetime.date(2020, 3, 3)
datetime.date(2021, 2, 6)
datetime.date(2022, 3, 5)

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

Gets a Date object for the current month.

Parameters:	before_today – include days in current month before today after_today – include days in current month after today
Example:	dtdate(‘2012-04-04’)
Returns:	dtdate
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_month()
...
datetime.date(2023, 3, 21)
datetime.date(2023, 3, 10)
datetime.date(2023, 3, 19)
datetime.date(2023, 3, 22)
datetime.date(2023, 3, 11)

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

Gets a Date object for the current year.

Parameters:	before_today – include days in current year before today after_today – include days in current year after today
Example:	Date(‘2012-04-04’)
Returns:	Date
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_this_year()
...
datetime.date(2023, 2, 7)
datetime.date(2023, 3, 15)
datetime.date(2023, 2, 10)
datetime.date(2023, 1, 4)
datetime.date(2023, 1, 26)

date_time(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime¶

Get a datetime object for a date between January 1, 1970 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘2005-08-16 20:39:21’) :return: datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(1996, 3, 20, 7, 46, 39)
datetime.datetime(2021, 7, 31, 1, 24, 38)
datetime.datetime(1998, 8, 15, 8, 43, 22)
datetime.datetime(1972, 10, 3, 5, 52, 26)
datetime.datetime(1987, 8, 15, 9, 51, 25)

date_time_ad(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.datetime¶

Get a datetime object for a date between January 1, 001 and now :param tzinfo: timezone, instance of datetime.tzinfo subclass :example: datetime(‘1265-03-22 21:15:52’) :return: datetime

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_ad()
...
datetime.datetime(932, 7, 17, 1, 20, 13)
datetime.datetime(2009, 8, 3, 21, 25)
datetime.datetime(58, 3, 29, 17, 26, 45)
datetime.datetime(1023, 4, 21, 11, 47, 46)
datetime.datetime(1961, 7, 18, 3, 50, 16)

date_time_between(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30y', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

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

Parameters:	start_date – Defaults to 30 years ago end_date – Defaults to “now” tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘1999-02-02 11:42:52’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2021, 12, 15, 17, 54, 31)
datetime.datetime(2006, 5, 2, 7, 10, 11)
datetime.datetime(2019, 1, 6, 3, 59, 11)
datetime.datetime(2007, 7, 15, 7, 38, 33)
datetime.datetime(1994, 8, 8, 18, 13, 5)

date_time_between_dates(datetime_start: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, datetime_end: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

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

Parameters:	datetime_start – datetime datetime_end – datetime tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘1999-02-02 11:42:52’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates()
...
datetime.datetime(2023, 3, 23, 20, 4, 52)
datetime.datetime(2023, 3, 23, 20, 4, 52)
datetime.datetime(2023, 3, 23, 20, 4, 52)
datetime.datetime(2023, 3, 23, 20, 4, 52)
datetime.datetime(2023, 3, 23, 20, 4, 52)

date_time_this_century(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

Gets a datetime object for the current century.

Parameters:	before_now – include days in current century before today after_now – include days in current century after today tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘2012-04-04 11:02:02’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_century()
...
datetime.datetime(2013, 2, 8, 15, 53, 19)
datetime.datetime(2014, 4, 23, 16, 21, 41)
datetime.datetime(2001, 5, 18, 2, 56, 13)
datetime.datetime(2008, 10, 22, 16, 55, 42)
datetime.datetime(2017, 5, 24, 21, 37, 28)

date_time_this_decade(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

Gets a datetime object for the decade year.

Parameters:	before_now – include days in current decade before today after_now – include days in current decade after today tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘2012-04-04 11:02:02’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_decade()
...
datetime.datetime(2021, 8, 21, 10, 59, 9)
datetime.datetime(2023, 3, 23, 10, 35, 17)
datetime.datetime(2021, 10, 15, 8, 2, 42)
datetime.datetime(2020, 3, 3, 21, 22, 1)
datetime.datetime(2021, 2, 6, 5, 6, 57)

date_time_this_month(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

Gets a datetime object for the current month.

Parameters:	before_now – include days in current month before today after_now – include days in current month after today tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘2012-04-04 11:02:02’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2023, 3, 21, 11, 54, 40)
datetime.datetime(2023, 3, 10, 8, 25, 17)
datetime.datetime(2023, 3, 19, 9, 32, 25)
datetime.datetime(2023, 3, 22, 14, 36, 16)
datetime.datetime(2023, 3, 11, 5, 0, 2)

date_time_this_year(before_now: bool = True, after_now: bool = False, tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

Gets a datetime object for the current year.

Parameters:	before_now – include days in current year before today after_now – include days in current year after today tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘2012-04-04 11:02:02’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year()
...
datetime.datetime(2023, 2, 7, 9, 41, 11)
datetime.datetime(2023, 3, 15, 14, 9, 42)
datetime.datetime(2023, 2, 10, 20, 0, 10)
datetime.datetime(2023, 1, 4, 22, 20, 7)
datetime.datetime(2023, 1, 26, 3, 19, 11)

day_of_month() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_month()
...
'20'
'31'
'15'
'03'
'15'

day_of_week()¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.day_of_week()
...
'mercoledì'
'sabato'
'sabato'
'martedì'
'sabato'

future_date(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.date¶

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

Parameters:	end_date – Defaults to “+30d” tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	dtdate(‘2030-01-01’)
Returns:	dtdate
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_date()
...
datetime.date(2023, 4, 11)
datetime.date(2023, 4, 13)
datetime.date(2023, 3, 25)
datetime.date(2023, 4, 5)
datetime.date(2023, 4, 17)

future_datetime(end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '+30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

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

Parameters:	end_date – Defaults to “+30d” tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘1999-02-02 11:42:52’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime()
...
datetime.datetime(2023, 4, 11, 12, 55, 28)
datetime.datetime(2023, 4, 13, 6, 4, 58)
datetime.datetime(2023, 3, 25, 19, 14, 56)
datetime.datetime(2023, 4, 5, 9, 44, 28)
datetime.datetime(2023, 4, 17, 15, 45, 34)

iso8601(tzinfo: Optional[datetime.tzinfo] = None, end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, sep: str = 'T', timespec: str = 'auto') → str¶

Get a timestamp in ISO 8601 format (or one of its profiles). :param tzinfo: timezone, instance of datetime.tzinfo subclass :param sep: separator between date and time, defaults to ‘T’ :param timespec: format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation :example: ‘2003-10-21T16:05:52+0000’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iso8601()
...
'1996-03-20T07:46:39'
'2021-07-31T01:24:38'
'1998-08-15T08:43:22'
'1972-10-03T05:52:26'
'1987-08-15T09:51:25'

month() → str¶

Examples:

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

month_name()¶

Examples:

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

past_date(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.date¶

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

Parameters:	start_date – Defaults to “-30d” tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	dtdate(‘1999-02-02’)
Returns:	dtdate
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_date()
...
datetime.date(2023, 3, 11)
datetime.date(2023, 3, 13)
datetime.date(2023, 2, 22)
datetime.date(2023, 3, 5)
datetime.date(2023, 3, 17)

past_datetime(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', tzinfo: Optional[datetime.tzinfo] = None) → datetime.datetime¶

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

Parameters:	start_date – Defaults to “-30d” tzinfo – timezone, instance of datetime.tzinfo subclass
Example:	datetime(‘1999-02-02 11:42:52’)
Returns:	datetime
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.past_datetime()
...
datetime.datetime(2023, 3, 12, 12, 55, 27)
datetime.datetime(2023, 3, 14, 6, 4, 57)
datetime.datetime(2023, 2, 23, 19, 14, 55)
datetime.datetime(2023, 3, 6, 9, 44, 27)
datetime.datetime(2023, 3, 18, 15, 45, 33)

pytimezone(*args, **kwargs) → Optional[datetime.tzinfo]¶

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

Example:	faker.pytimezone()
Returns:	dateutil.tz.tz.tzfile
Examples:

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

time(pattern: str = '%H:%M:%S', end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → str¶

Get a time string (24h format by default) :param pattern: format :example: ‘15:02:34’

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'07:46:39'
'01:24:38'
'08:43:22'
'05:52:26'
'09:51:25'

time_delta(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.timedelta¶

Get a timedelta object

Examples:

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

time_object(end_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → datetime.time¶

Get a time object :example: datetime.time(15, 56, 56, 772876)

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(7, 46, 39)
datetime.time(1, 24, 38)
datetime.time(8, 43, 22)
datetime.time(5, 52, 26)
datetime.time(9, 51, 25)

time_series(start_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = '-30d', end_date: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int] = 'now', precision: Optional[float] = None, distrib: Optional[Callable[[datetime.datetime], float]] = None, tzinfo: Optional[datetime.tzinfo] = None) → Iterator[Tuple[datetime.datetime, Any]]¶

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

The data points will start at start_date, and be at every time interval specified by precision. distrib is a callable that accepts <datetime> and returns <value>

Examples:

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

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: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None, start_datetime: Union[datetime.date, datetime.datetime, datetime.timedelta, str, int, None] = None) → int¶

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.unix_time()
...
827307999
1627694678
903170602
86939546
556019485

year() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.year()
...
'1996'
'2021'
'1998'
'1972'
'1987'

`faker.providers.internet`¶

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

Bases: faker.providers.internet.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: Optional[int] = None, month: Optional[int] = None, day: Optional[int] = None, tld: Optional[str] = None, length: Optional[int] = 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: Optional[str] = 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'

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: Optional[int] = None, height: Optional[int] = None, placeholder_url: Optional[str] = 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: Optional[str] = None, private: Optional[str] = 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: Optional[str] = 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: Optional[str] = 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() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.mac_address()
...
'c5:d7:14:84:f8:cf'
'9b:f4:b7:6f:47:90'
'47:30:80:4b:9e:32'
'25:a9:f1:33:b5:de'
'a1:68:f4:e2:85:1f'

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: Optional[str] = None) → str¶

Django algorithm

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'molestiae-nihil'
'facilis-quaerat'
'necessitatibus'
'perferendis-magnam'
'esse-quae-deserunt'

tld() → str¶

Examples:

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

uri() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://www.tornatore-speri.org/category/list/main/'
'http://cadorna.it/posts/list/search/terms.html'
'https://www.rizzo-mercadante.it/register.jsp'
'https://www.angeli.it/posts/search/terms.php'
'http://www.coardi.com/'

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: Optional[int] = None) → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_path()
...
'posts/tag'
'explore/tag'
'explore/category'
'blog'
'category'

url(schemes: Optional[List[str]] = 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.person`¶

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

Bases: faker.providers.person.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: faker.providers.phone_number.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: faker.providers.ssn.Provider

Generates italian fiscal codes.

ssn() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ssn()
...
'PGLNNL33P56E360E'
'SNSMCL74D57B499Z'
'CLBCSR79E58H575Q'
'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'

Locale it_IT¶

faker.providers.address¶

faker.providers.automotive¶

faker.providers.bank¶

faker.providers.company¶

faker.providers.currency¶

faker.providers.date_time¶

faker.providers.internet¶

faker.providers.person¶

faker.providers.phone_number¶

faker.providers.ssn¶