Locale es_ES¶
faker.providers.address
¶
-
class
faker.providers.address.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.address.es.Provider
-
address
() → str¶ Example: ‘791 Crist Parks, Sashabury, IL 86039-9874’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.address() ... 'Callejón Ariadna Torre 84 Piso 9 \nMálaga, 10127' 'Callejón Virginia Collado 21\nLugo, 37687' 'Alameda de Emiliana Fuente 977 Piso 0 \nÁvila, 48166' 'Alameda de Jose Francisco Morell 4\nCiudad, 10338' 'Alameda Sara Verdejo 51\nTeruel, 09179'
-
administrative_unit
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.administrative_unit() ... 'Jaén' 'Valladolid' 'La Rioja' 'Alicante' 'Córdoba'
-
autonomous_community
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.autonomous_community() ... 'Comunidad de Madrid' 'Región de Murcia' 'Aragón' 'Cataluña' 'La Rioja'
-
building_number
() → str¶ Example: ‘791’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.building_number() ... '16' '88' '84' '49' '324'
-
city
() → str¶ Example: ‘Sashabury’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.city() ... 'Valladolid' 'Alicante' 'Málaga' 'La Coruña' 'Lugo'
-
city_suffix
() → str¶ Example: ‘town’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.city_suffix() ... 'Ville' 'Ville' 'Ville' 'Ville' 'Ville'
-
country
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.country() ... 'Líbano' 'Maldivas' 'Australia' 'Georgia' 'Palau'
-
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() ... 'Spain' 'Spain' 'Spain' 'Spain' 'Spain'
-
current_country_code
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.current_country_code() ... 'ES' 'ES' 'ES' 'ES' 'ES'
-
postcode
() → str¶ Example: 86039-9874 Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.postcode() ... '26247' '50673' '28562' '03653' '17968'
-
region
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.region() ... 'Comunidad de Madrid' 'Región de Murcia' 'Aragón' 'Cataluña' 'La Rioja'
-
secondary_address
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.secondary_address() ... 'Piso 6' 'Apt. 48' 'Piso 6' 'Piso 7' 'Piso 9'
-
state
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.state() ... 'Jaén' 'Valladolid' 'La Rioja' 'Alicante' 'Córdoba'
-
state_name
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.state_name() ... 'Jaén' 'Valladolid' 'La Rioja' 'Alicante' 'Córdoba'
-
street_address
() → str¶ Example: ‘791 Crist Parks’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.street_address() ... 'Calle de Juan Antonio Vidal 56 Piso 5 ' 'Cañada Enrique Bustamante 348' 'Avenida Trini Murillo 28 Piso 6 ' 'Paseo Albina Salas 940 Apt. 16 ' 'Alameda de Jose Francisco Morell 4'
-
street_name
() → str¶ Example: ‘Crist Parks’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.street_name() ... 'Ronda de Apolinar Jove' 'C. de Zaida Mateos' 'Acceso de Dalila Gil' 'Cañada Enrique Bustamante' 'Paseo de Julieta Collado'
-
street_prefix
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.street_prefix() ... 'C.' 'Ronda' 'Calle' 'Callejón' 'Pasadizo'
-
street_suffix
() → str¶ Example: ‘Avenue’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.street_suffix() ... 'Street' 'Street' 'Street' 'Street' 'Street'
-
faker.providers.automotive
¶
-
class
faker.providers.automotive.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.automotive.Provider
Implement automotive provider for
es_ES
locale.Sources:
-
license_plate
() → str¶ Generate a license plate.
This method randomly chooses (50/50) between
license_plate_unified()
orlicense_plate_by_province()
to generate the result.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.license_plate() ... '8764 SCL' '8242 PYJ' 'PO 9241 IT' 'ZA 7815 XK' '8778 NZJ'
-
license_plate_by_province
(province_prefix: Optional[str] = None) → str¶ Generate a provincial license plate.
If a value for
province_prefix
is provided, the value will be used as the prefix regardless of validity. IfNone
, then a valid prefix will be selected at random.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.license_plate_by_province() ... 'ZA 0487 MN' 'J 5938 JP' 'C 1948 JE' 'SS 4115 VE' 'M 5659 TD'
-
license_plate_unified
() → str¶ Generate a unified license plate.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.license_plate_unified() ... '4876 RSC' '9382 MVP' '9489 MGF' '1578 GMF' '5938 FPS'
-
vin
() → str¶ Generate vin number.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.vin() ... 'RT3GZYSKXXNDZ9J97' 'G0K75MX77NULDXVG4' '16S1YMFL25CEF0V66' 'LZY7KJ8M0DJV6RLFJ' 'BCB3GX5649036SHFD'
-
faker.providers.bank
¶
-
class
faker.providers.bank.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.bank.Provider
Implement bank provider for
es_ES
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() ... 'ES' 'ES' 'ES' 'ES' 'ES'
-
bban
() → str¶ Generate a Basic Bank Account Number (BBAN).
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.bban() ... '66048764759382421948' '92411578156593877840' '80160975351393328711' '58714841858398947196' '59342320947112201868'
-
iban
() → str¶ Generate an International Bank Account Number (IBAN).
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.iban() ... 'ES1266048764759382421948' 'ES0392411578156593877840' 'ES9680160975351393328711' 'ES2658714841858398947196' 'ES6659342320947112201868'
-
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 beNone
or the integers8
or11
. If the value isNone
, then a value of8
or11
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 oflength
is11
. Ifprimary
isTrue
andlength
is11
, 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
isTrue
, 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 ifuse_dataset
wereFalse
, 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() ... 'YNBIES65ZT4' 'SGQEESSIGQ8' 'JDXCESV4' 'LNKTESN9' 'OQIBES9AFZA'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift(length=8) ... 'MYNBESQ6' 'PMZJES4W' 'SGQEESSI' 'YDTZESQ8' 'WZTEESTG'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift(length=8, use_dataset=True) ... 'MYNBESQ6' 'PMZJES4W' 'SGQEESSI' 'YDTZESQ8' 'WZTEESTG'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift(length=11) ... 'MYNBESQ65ZT' 'PLSGES6ISIG' 'TZIRESJTGEV' 'PRDLES1UN94' 'OQIBES9AFZA'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift(length=11, primary=True) ... 'MYNBESQ6XXX' 'PMZJES4WXXX' 'SGQEESSIXXX' 'YDTZESQ8XXX' 'WZTEESTGXXX'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift(length=11, use_dataset=True) ... 'MYNBESQ65ZT' 'PLSGES6ISIG' 'TZIRESJTGEV' 'PRDLES1UN94' 'OQIBES9AFZA'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift(length=11, primary=True, use_dataset=True) ... 'MYNBESQ6XXX' 'PMZJES4WXXX' 'SGQEESSIXXX' 'YDTZESQ8XXX' 'WZTEESTGXXX'
-
swift11
(primary: bool = False, use_dataset: bool = False) → str¶ Generate an 11-digit SWIFT code.
This method uses
swift()
under the hood with thelength
argument set to11
. Ifprimary
is set toTrue
, 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() ... 'MYNBESQ65ZT' 'PLSGES6ISIG' 'TZIRESJTGEV' 'PRDLES1UN94' 'OQIBES9AFZA'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift11(use_dataset=True) ... 'MYNBESQ65ZT' 'PLSGES6ISIG' 'TZIRESJTGEV' 'PRDLES1UN94' 'OQIBES9AFZA'
-
swift8
(use_dataset: bool = False) → str¶ Generate an 8-digit SWIFT code.
This method uses
swift()
under the hood with thelength
argument set to8
and with theprimary
argument omitted. All 8-digit SWIFT codes already refer to the primary branch/office.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.swift8() ... 'MYNBESQ6' 'PMZJES4W' 'SGQEESSI' 'YDTZESQ8' 'WZTEESTG'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.swift8(use_dataset=True) ... 'MYNBESQ6' 'PMZJES4W' 'SGQEESSI' 'YDTZESQ8' 'WZTEESTG'
-
faker.providers.barcode
¶
-
class
faker.providers.barcode.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.barcode.Provider
Implement barcode provider for
es_ES
locale.Sources:
-
ean
(length: int = 13, prefixes: Tuple[Union[int, str, Tuple[Union[int, str], ...]], ...] = ()) → str¶ Generate an EAN barcode of the specified
length
.The value of
length
can only be8
or13
(default) which will create an EAN-8 or an EAN-13 barcode respectively.If a value for
prefixes
is specified, the result will begin with one of the sequences inprefixes
.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ean(length=13) ... '6604876475937' '8242194892418' '1578156593879' '7840801609759' '3513933287112'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean(length=8) ... '66048763' '47593824' '42194897' '24115780' '15659385'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean(prefixes=('00', )) ... '0004876475931' '0019489241156' '0056593877840' '0016097535134' '0087115871480'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean(prefixes=('45', '49')) ... '4504876475932' '4919489241155' '4556593877841' '4516097535135' '4987115871489'
-
ean13
(prefixes: Tuple[Union[int, str, Tuple[Union[int, str], ...]], ...] = ()) → str¶ Generate an EAN-13 barcode.
This method uses
ean()
under the hood with thelength
argument explicitly set to13
.If a value for
prefixes
is specified, the result will begin with one of the sequences inprefixes
.Note
Codes starting with a leading zero are treated specially in some barcode readers. For more information on compatibility with UPC-A codes, see
EnUsBarcodeProvider.ean13()
.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ean13() ... '6604876475937' '8242194892418' '1578156593879' '7840801609759' '3513933287112'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean13(prefixes=('00', )) ... '0004876475931' '0019489241156' '0056593877840' '0016097535134' '0087115871480'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean13(prefixes=('45', '49')) ... '4504876475932' '4919489241155' '4556593877841' '4516097535135' '4987115871489'
-
ean8
(prefixes: Tuple[()] = ()) → str¶ Generate an EAN-8 barcode.
This method uses
ean()
under the hood with thelength
argument explicitly set to8
.If a value for
prefixes
is specified, the result will begin with one of the sequences inprefixes
.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ean8() ... '66048763' '47593824' '42194897' '24115780' '15659385'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean8(prefixes=('00', )) ... '00048767' '00938242' '00489249' '00781565' '00877848'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.ean8(prefixes=('45', '49')) ... '49048766' '45938245' '45489242' '49781564' '45877841'
-
localized_ean
(length: int = 13) → str¶ Generate a localized EAN barcode of the specified
length
.The value of
length
can only be8
or13
(default) which will create an EAN-8 or an EAN-13 barcode respectively.This method uses the standard barcode provider’s
ean()
under the hood with theprefixes
argument explicitly set tolocal_prefixes
of a localized barcode provider implementation.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.localized_ean() ... '8404876475931' '8419489241156' '8456593877840' '8416097535134' '8487115871480'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.localized_ean(length=13) ... '8404876475931' '8419489241156' '8456593877840' '8416097535134' '8487115871480'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.localized_ean(length=8) ... '84048769' '84938244' '84489241' '84781567' '84877840'
-
localized_ean13
() → str¶ Generate a localized EAN-13 barcode.
This method uses
localized_ean()
under the hood with thelength
argument explicitly set to13
.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.localized_ean13() ... '8404876475931' '8419489241156' '8456593877840' '8416097535134' '8487115871480'
-
localized_ean8
() → str¶ Generate a localized EAN-8 barcode.
This method uses
localized_ean()
under the hood with thelength
argument explicitly set to8
.Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.localized_ean8() ... '84048769' '84938244' '84489241' '84781567' '84877840'
-
faker.providers.color
¶
-
class
faker.providers.color.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.color.es.Provider
-
color
(hue: Optional[HueType] = None, luminosity: Optional[str] = None, color_format: str = 'hex') → str¶ Generate a color in a human-friendly way.
Under the hood, this method first creates a color represented in the HSV color model and then converts it to the desired
color_format
. The argumenthue
controls the H value according to the following rules:- If the value is a number from
0
to360
, it will serve as the H value of the generated color. - If the value is a tuple/list of 2 numbers from 0 to 360, the color’s H value will be randomly selected from that range.
- If the value is a valid string, the color’s H value will be randomly
selected from the H range corresponding to the supplied string. Valid
values are
'monochrome'
,'red'
,'orange'
,'yellow'
,'green'
,'blue'
,'purple'
, and'pink'
.
The argument
luminosity
influences both S and V values and is partially affected byhue
as well. The finer details of this relationship are somewhat involved, so please refer to the source code instead if you wish to dig deeper. To keep the interface simple, this argument either can be omitted or can accept the following string values:'bright'
,'dark'
,'light'
, or'random'
.The argument
color_format
controls in which color model the color is represented. Valid values are'hsv'
,'hsl'
,'rgb'
, or'hex'
(default).Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.color(hue='red') ... '#af2f33' '#e02141' '#ef6466' '#a80a14' '#ed9e95'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.color(luminosity='light') ... '#79c3e0' '#89ffa1' '#96cbf7' '#aafaff' '#e3f495'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.color(hue=(100, 200), color_format='rgb') ... 'rgb(26, 155, 88)' 'rgb(9, 193, 49)' 'rgb(73, 229, 154)' 'rgb(107, 249, 166)' 'rgb(76, 204, 69)'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.color(hue='orange', luminosity='bright') ... '#efc332' '#edae65' '#d1861d' '#ffcc42' '#e09533'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.color(hue=135, luminosity='dark', color_format='hsv') ... 'hsv(135, 96, 45)' 'hsv(135, 98, 57)' 'hsv(135, 94, 61)' 'hsv(135, 99, 47)' 'hsv(135, 94, 50)'
>>> Faker.seed(0) >>> for _ in range(5): ... fake.color(hue=(300, 20), luminosity='random', color_format='hsl') ... 'hsl(217, 94, 27)' 'hsl(40, 23, 54)' 'hsl(268, 100, 74)' 'hsl(175, 43, 31)' 'hsl(131, 47, 11)'
- If the value is a number from
-
color_name
() → str¶ Generate a color name.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.color_name() ... 'Rojo' 'Rosa brumoso' 'Amarillo verde' 'Gris gainsboro (Estaño)' 'Verde prado'
-
hex_color
() → str¶ Generate a color formatted as a hex triplet.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.hex_color() ... '#d82c08' '#629f70' '#c2094d' '#e3e707' '#6baa95'
-
rgb_color
() → str¶ Generate a color formatted as a comma-separated RGB value.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.rgb_color() ... '197,215,20' '132,248,207' '155,244,183' '111,71,144' '71,48,128'
-
rgb_css_color
() → str¶ Generate a color formatted as a CSS rgb() function.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.rgb_css_color() ... 'rgb(197,215,20)' 'rgb(132,248,207)' 'rgb(155,244,183)' 'rgb(111,71,144)' 'rgb(71,48,128)'
-
safe_color_name
() → str¶ Generate a web-safe color name.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.safe_color_name() ... 'azul' 'blanco' 'azul' 'negro' 'violeta'
-
safe_hex_color
() → str¶ Generate a web-safe color formatted as a hex triplet.
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.safe_hex_color() ... '#ccdd11' '#88ffcc' '#99ffbb' '#664499' '#443388'
-
faker.providers.currency
¶
-
class
faker.providers.currency.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.currency.es.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', 'Kwacha malauí') ('NZD', 'Dólar neozelandés') ('BAM', 'Marco bosnioherzegovino') ('IRR', 'Rial iraní') ('SPL', '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() ... 'Kwacha malauí' 'Dólar neozelandés' 'Marco bosnioherzegovino' 'Rial iraní' 'Luigino'
-
currency_symbol
(code: Optional[str] = None) → str¶ Example: $ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.currency_symbol() ... '$' '$' 'KM' 'kr' 'L'
-
pricetag
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.pricetag() ... '7.604,87\xa0€' '975,93\xa0€' '54,21\xa0€' '89.241,15\xa0€' '91.565,93\xa0€'
-
faker.providers.date_time
¶
-
class
faker.providers.date_time.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.date_time.es.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(2022, 4, 3) datetime.date(2006, 8, 18) datetime.date(2019, 4, 24) datetime.date(2007, 10, 31) datetime.date(1994, 11, 25)
-
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, 7, 11) datetime.date(2023, 7, 11) datetime.date(2023, 7, 11) datetime.date(2023, 7, 11) datetime.date(2023, 7, 11)
-
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, 6, 13) datetime.date(1959, 12, 15) datetime.date(2010, 9, 6) datetime.date(1964, 10, 5) datetime.date(1913, 1, 12)
-
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(2023, 3, 23) datetime.date(2021, 10, 15) datetime.date(2020, 3, 3) datetime.date(2021, 2, 6)
-
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, 7, 5) datetime.date(2023, 7, 10) datetime.date(2023, 7, 6) datetime.date(2023, 7, 1) datetime.date(2023, 7, 4)
-
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, 6, 13) datetime.date(2023, 3, 16) datetime.date(2023, 5, 28) datetime.date(2023, 6, 22) datetime.date(2023, 3, 23)
-
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
Parameters: tzinfo – timezone, instance of datetime.tzinfo subclass Example: datetime(‘2005-08-16 20:39:21’) Returns: datetime Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time() ... datetime.datetime(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
Parameters: tzinfo – timezone, instance of datetime.tzinfo subclass Example: datetime(‘1265-03-22 21:15:52’) Returns: datetime Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.date_time_ad() ... datetime.datetime(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(2022, 4, 4, 16, 10, 58) datetime.datetime(2006, 8, 20, 5, 26, 38) datetime.datetime(2019, 4, 26, 2, 15, 38) datetime.datetime(2007, 11, 2, 5, 55) datetime.datetime(1994, 11, 26, 16, 29, 32)
-
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, 7, 11, 18, 21, 19) datetime.datetime(2023, 7, 11, 18, 21, 19) datetime.datetime(2023, 7, 11, 18, 21, 19) datetime.datetime(2023, 7, 11, 18, 21, 19) datetime.datetime(2023, 7, 11, 18, 21, 19)
-
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, 7, 11, 5, 57, 20) datetime.datetime(2023, 7, 5, 16, 12, 38) datetime.datetime(2023, 7, 10, 4, 46, 12) datetime.datetime(2023, 7, 6, 2, 30, 1) datetime.datetime(2023, 7, 1, 11, 47, 30)
-
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, 6, 13, 23, 17, 27) datetime.datetime(2023, 3, 16, 19, 22, 23) datetime.datetime(2023, 5, 28, 4, 19, 24) datetime.datetime(2023, 6, 22, 20, 50, 14) datetime.datetime(2023, 3, 23, 16, 0, 20)
-
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() ... 'miércoles' 'sábado' 'sábado' 'martes' 'sábado'
-
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, 7, 30) datetime.date(2023, 8, 1) datetime.date(2023, 7, 13) datetime.date(2023, 7, 24) datetime.date(2023, 8, 5)
-
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, 7, 30, 11, 11, 55) datetime.datetime(2023, 8, 1, 4, 21, 25) datetime.datetime(2023, 7, 13, 17, 31, 23) datetime.datetime(2023, 7, 24, 8, 0, 55) datetime.datetime(2023, 8, 5, 14, 2, 1)
-
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).
Parameters: - tzinfo – timezone, instance of datetime.tzinfo subclass
- sep – separator between date and time, defaults to ‘T’
- timespec – format specifier for the time part, defaults to ‘auto’ - see datetime.isoformat() documentation
Example: ‘2003-10-21T16:05:52+0000’
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.iso8601() ... '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' 'julio' 'agosto' 'octubre' '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, 6, 29) datetime.date(2023, 7, 1) datetime.date(2023, 6, 12) datetime.date(2023, 6, 23) datetime.date(2023, 7, 5)
-
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, 6, 30, 11, 11, 54) datetime.datetime(2023, 7, 2, 4, 21, 24) datetime.datetime(2023, 6, 13, 17, 31, 22) datetime.datetime(2023, 6, 24, 8, 0, 54) datetime.datetime(2023, 7, 6, 14, 2)
-
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)
Parameters: 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 byprecision
.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 0x7f860f90e1d0> <generator object Provider.time_series at 0x7f860f90e1d0> <generator object Provider.time_series at 0x7f860f90e1d0> <generator object Provider.time_series at 0x7f860f90e1d0> <generator object Provider.time_series at 0x7f860f90e1d0>
-
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.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.internet.Provider
-
ascii_company_email
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ascii_company_email() ... 'crivero@vidal-torre.es' 'albina59@vargas.org' 'marisolbustamante@iglesia.com' 'murilloagustina@cabrero.es' 'carminatapia@vazquez-julia.com'
-
ascii_email
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ascii_email() ... 'qarjona@hotmail.com' 'emateos@yahoo.com' 'lopechaves@iglesia.com' 'benaventtrini@hotmail.com' 'wcabrero@yahoo.com'
-
ascii_free_email
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ascii_free_email() ... 'crivero@yahoo.com' 'yquiros@yahoo.com' 'lpalma@gmail.com' 'lopechaves@gmail.com' 'virginia89@gmail.com'
-
ascii_safe_email
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ascii_safe_email() ... 'crivero@example.com' 'yquiros@example.com' 'lpalma@example.org' 'lopechaves@example.org' 'virginia89@example.org'
-
company_email
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.company_email() ... 'crivero@vidal-torre.es' 'albina59@vargas.org' 'marisolbustamante@iglesia.com' 'murilloagustina@cabrero.es' 'carminatapia@vazquez-julia.com'
-
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' 'uqniukqjckmjabijnuqho.com'
-
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() ... 'rivero-arjona.org' 'torre.es' 'gil-vargas.com' 'chaves-bustamante.org' 'collado.com'
-
domain_word
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.domain_word() ... 'rivero-arjona' 'vidal-torre' 'mateos-tapia' 'gil-vargas' 'lujan'
-
email
(safe: bool = True, domain: Optional[str] = None) → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.email() ... 'crivero@example.com' 'yquiros@example.com' 'lpalma@example.org' 'lopechaves@example.org' 'virginia89@example.org'
-
free_email
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.free_email() ... 'crivero@yahoo.com' 'yquiros@yahoo.com' 'lpalma@gmail.com' 'lopechaves@gmail.com' 'virginia89@gmail.com'
-
free_email_domain
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.free_email_domain() ... 'yahoo.com' 'yahoo.com' 'gmail.com' 'yahoo.com' '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.jove.es' 'laptop-47.gil-vargas.com' 'desktop-21.iglesia.com' 'email-15.cabrero-otero.es' 'desktop-93.tapia.org'
-
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: 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: 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() ... 'crivero@example.com' 'yquiros@example.com' 'lpalma@example.org' 'lopechaves@example.org' 'virginia89@example.org'
-
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() ... 'es' 'es' 'com' 'org' 'es'
-
uri
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.uri() ... 'https://www.vidal-torre.es/explore/category/main/' 'http://bustamante.org/explore/posts/list/post.html' 'https://cabrero.es/' 'http://vazquez-julia.com/list/main/list/terms.html' 'https://morell.com/posts/main.htm'
-
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://jove.es/' 'https://palma-gil.com/' 'https://www.iglesia.com/' 'https://www.benavent.com/' 'https://fuente-tapia.es/'
-
user_name
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.user_name() ... 'crivero' 'ariadna76' 'albina59' 'annachaparro' 'enrique19'
-
faker.providers.job
¶
-
class
faker.providers.job.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.job.es.Provider
-
job
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.job() ... 'Técnico en asistencia al usuario de tecnología de la información y las comunicaciones' 'Geólogo' 'Recolector de basura y material reciclable' 'Trabajador comunitario de la salud' 'Ingeniero de minas'
-
faker.providers.person
¶
-
class
faker.providers.person.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.person.es.Provider
-
first_name
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.first_name() ... 'Rafaela' 'Rogelio' 'Marta' 'Tania' 'Sosimo'
-
first_name_female
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.first_name_female() ... 'Sonia' 'Gabriela' 'Purificación' 'Vilma' 'Ignacia'
-
first_name_male
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.first_name_male() ... 'Telmo' 'Guadalupe' 'Reynaldo' 'Victor' 'Humberto'
-
first_name_nonbinary
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.first_name_nonbinary() ... 'Rafaela' 'Rogelio' 'Marta' 'Tania' 'Sosimo'
-
language_name
() → str¶ Generate a random i18n language name (e.g. English).
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.language_name() ... 'Letón' 'Maltés' 'Aimara' 'Igbo' 'Romanche'
-
last_name
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.last_name() ... 'Plaza' 'Rivero' 'Arjona' 'Jove' 'Vidal'
-
last_name_female
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.last_name_female() ... 'Plaza' 'Rivero' 'Arjona' 'Jove' 'Vidal'
-
last_name_male
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.last_name_male() ... 'Plaza' 'Rivero' 'Arjona' 'Jove' 'Vidal'
-
last_name_nonbinary
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.last_name_nonbinary() ... 'Plaza' 'Rivero' 'Arjona' 'Jove' 'Vidal'
-
name
() → str¶ Example: ‘John Doe’ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.name() ... 'Purificación Rivero Arjona' 'José Mari Torre-Quirós' 'Jorge Gastón Gil Vargas' 'Epifanio Chaves Bustamante' 'Rosalía Dionisia Collado Menéndez'
-
name_female
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.name_female() ... 'Purificación Rivero' 'Dora Vidal Torre' 'Ágata Mateos' 'Felisa de Vargas' 'Elisabet Chaves Bustamante'
-
name_male
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.name_male() ... 'Reynaldo Rivero' 'Efraín Vidal Torre' 'Ángel Mateos' 'Gastón de Vargas' 'Epifanio Chaves Bustamante'
-
name_nonbinary
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.name_nonbinary() ... 'Purificación Rivero Arjona' 'José Mari Torre-Quirós' 'Jorge Gastón Gil Vargas' 'Epifanio Chaves Bustamante' 'Rosalía Dionisia Collado Menéndez'
-
prefix
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.prefix() ... 'del' 'del' 'de' 'del' 'del'
-
prefix_female
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.prefix_female() ... 'del' 'del' 'de' 'del' 'del'
-
prefix_male
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.prefix_male() ... 'del' 'del' 'de' 'del' 'del'
-
prefix_nonbinary
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.prefix_nonbinary() ... 'del' 'del' 'de' 'del' 'del'
-
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.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.phone_number.Provider
According to official specs: https://avancedigital.mineco.gob.es/es-ES/Servicios/Numeracion/Documents/Guia_Numeracion.pdf
-
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() ... '+34942604876' '+34901759382' '+34 887 219 489' '+34 845 411 578' '+34 826565938'
-
faker.providers.ssn
¶
-
class
faker.providers.ssn.es_ES.
Provider
(generator: Any)¶ Bases:
faker.providers.ssn.Provider
A Faker provider for the Spanish VAT IDs and DOIs
-
cif
() → str¶ https://es.wikipedia.org/wiki/C%C3%B3digo_de_identificaci%C3%B3n_fiscal :return: a random Spanish CIF
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.cif() ... 'V5261486D' 'G67082966' 'V8324259D' 'C82355256' 'C85708360'
-
doi
() → str¶ https://es.wikipedia.org/wiki/Identificador_de_objeto_digital :return: a random Spanish CIF or NIE or NIF
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.doi() ... 'X9614325A' '83901644J' 'Y2989224C' 'Y9994100Q' 'Q1820476H'
-
nie
() → str¶ https://es.wikipedia.org/wiki/N%C3%BAmero_de_identidad_de_extranjero :return: a random Spanish NIE
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.nie() ... 'Z8646214J' 'Z8475291A' 'Z2587427R' 'Y9701714Y' 'X1652547C'
-
nif
() → str¶ https://es.wikipedia.org/wiki/N%C3%BAmero_de_identificaci%C3%B3n_fiscal :return: NIF
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.nif() ... '73954972J' '26856133E' '98580296L' '48182789C' '36967076G'
-
ssn
() → str¶ Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.ssn() ... '604-87-6475' '824-21-9489' '411-57-8156' '938-77-8408' '160-97-5351'
-
vat_id
() → str¶ http://ec.europa.eu/taxation_customs/vies/faq.html#item_11 :return: a random Spanish VAT ID
Examples: >>> Faker.seed(0) >>> for _ in range(5): ... fake.vat_id() ... 'ES60487647w' 'ESZ3824219q' 'ESJ9241157g' 'ES65938778q' 'ESp80160975'
-