`faker.providers.internet`¶

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

Bases: BaseProvider

ascii_company_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_company_email()
...
'achang@green.info'
'thull@howard-snow.com'
'juancampos@lloyd.org'
'kyleblair@rivera.com'
'tammywoods@green.com'

ascii_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_email()
...
'gwilliams@yahoo.com'
'tammy59@gmail.com'
'donald19@archer-patel.org'
'corey15@castro-gomez.com'
'hramos@brown-sellers.com'

ascii_free_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_free_email()
...
'achang@gmail.com'
'tammy76@yahoo.com'
'nhoward@hotmail.com'
'juancampos@hotmail.com'
'vanessa89@gmail.com'

ascii_safe_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ascii_safe_email()
...
'achang@example.org'
'tammy76@example.com'
'nhoward@example.net'
'juancampos@example.net'
'vanessa89@example.org'

company_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company_email()
...
'achang@green.info'
'thull@howard-snow.com'
'juancampos@lloyd.org'
'kyleblair@rivera.com'
'tammywoods@green.com'

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

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()
...
'chang-fisher.com'
'tucker.info'
'silva-odonnell.net'
'campbell.org'
'archer-patel.org'

domain_word() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_word()
...
'chang-fisher'
'sheppard-tucker'
'faulkner-howard'
'wagner'
'campos'

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

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'achang@example.org'
'tammy76@example.com'
'nhoward@example.net'
'juancampos@example.net'
'vanessa89@example.org'

free_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'achang@gmail.com'
'tammy76@yahoo.com'
'nhoward@hotmail.com'
'juancampos@hotmail.com'
'vanessa89@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.green.info'
'laptop-47.silva-odonnell.net'
'srv-42.montgomery.net'
'email-92.garcia-jones.com'
'laptop-81.hamilton-carr.com'

http_method() → str¶

Returns random HTTP method https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods

Return type:: str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_method()
...
'OPTIONS'
'OPTIONS'
'GET'
'DELETE'
'PATCH'

http_status_code(include_unassigned: bool = True) → int¶

Returns random HTTP status code https://www.rfc-editor.org/rfc/rfc9110#name-status-codes :param include_unassigned: Whether to include status codes which have

not yet been assigned or are unused

Returns:: a random three digit status code
Return type:: int
Example:: 404
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.http_status_code()
...
532
297
488
555
315

iana_id() → str¶

Returns IANA Registrar ID https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml

Return type:: str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iana_id()
...
'6463344'
'7056021'
'679216'
'4343903'
'8577767'

image_url(width: int | None = None, height: int | None = None, placeholder_url: str | None = None) → str¶

Returns URL to placeholder image Example: http://placehold.it/640x480

Parameters:

width – Optional image width
height – Optional image height
placeholder_url – Optional template string of image URLs from custom placeholder service. String must contain {width} and {height} placeholders, eg: https:/example.com/{width}/{height}.

Return type:

str

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.image_url()
...
'https://picsum.photos/788/861'
'https://dummyimage.com/530x995'
'https://dummyimage.com/621x976'
'https://dummyimage.com/447x285'
'https://placekitten.com/286/194'

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

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

Parameters:

network – Network address
address_class – IPv4 address class (a, b, or c)
private – Public or private

Returns:

IPv4

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4()
...
'171.174.170.81'
'95.25.112.121'
'51.105.121.194'
'195.110.164.126'
'141.250.247.54'

ipv4_network_class() → str¶

Returns a IPv4 network class ‘a’, ‘b’ or ‘c’.

Returns:: IPv4 network class
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_network_class()
...
'b'
'b'
'a'
'b'
'c'

ipv4_private(network: bool = False, address_class: str | None = None) → str¶

Returns a private IPv4.

Parameters:

network – Network address
address_class – IPv4 address class (a, b, or c)

Returns:

Private IPv4

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_private()
...
'172.29.117.82'
'10.248.203.131'
'172.25.180.188'
'172.22.253.123'
'192.168.71.140'

ipv4_public(network: bool = False, address_class: str | None = None) → str¶

Returns a public IPv4 excluding private blocks.

Parameters:

network – Network address
address_class – IPv4 address class (a, b, or c)

Returns:

Public IPv4

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv4_public()
...
'166.186.169.69'
'111.198.92.30'
'168.155.75.206'
'141.250.247.54'
'212.120.204.37'

ipv6(network: bool = False) → str¶

Produce a random IPv6 address or network with a valid CIDR

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ipv6()
...
'e3e7:682:c209:4cac:629f:6fbf:d82c:7cd'
'f728:b4fa:4248:5e3a:a5d:2f35:6baa:9455'
'eb11:67b3:67a9:c378:7c65:c1e6:82e2:e662'
'f7c1:bd87:4da5:e709:d471:3d61:c8a7:639'
'e443:df78:9558:867f:5ba9:1fb0:7a02:4204'

mac_address(multicast: bool = False) → str¶

Returns a random MAC address.

Parameters:: multicast – Multicast address
Returns:: MAC Address
Examples:

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

nic_handle(suffix: str = 'FAKE') → str¶

Returns NIC Handle ID https://www.apnic.net/manage-ip/using-whois/guide/person/

Return type:: str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handle()
...
'ZYT1598-FAKE'
'SIW493-FAKE'
'UE59352-FAKE'
'WBUN892-FAKE'
'CHQD98-FAKE'

nic_handles(count: int = 1, suffix: str = '????') → List[str]¶

Returns NIC Handle ID list

Return type:: list[str]
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.nic_handles()
...
['ZYT1598-EWLN']
['WGNZ53-QITZ']
['UERV52-EJGW']
['CHQ498-DZJA']
['UU1864-TEMK']

port_number(is_system: bool = False, is_user: bool = False, is_dynamic: bool = False) → int¶

Returns a network port number https://tools.ietf.org/html/rfc6335

Parameters:

is_system – System or well-known ports
is_user – User or registered ports
is_dynamic – Dynamic / private / ephemeral ports

Return type:

int

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.port_number()
...
50494
55125
5306
33936
63691

ripe_id() → str¶

Returns RIPE Organization ID https://www.ripe.net/manage-ips-and-asns/db/support/organisation-object-in-the-ripe-database

Return type:: str
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ripe_id()
...
'ORG-ZYT1598-RIPE'
'ORG-SIW493-RIPE'
'ORG-UE59352-RIPE'
'ORG-WBUN892-RIPE'
'ORG-CHQD98-RIPE'

safe_domain_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_domain_name()
...
'example.com'
'example.com'
'example.org'
'example.com'
'example.net'

safe_email() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.safe_email()
...
'achang@example.org'
'tammy76@example.com'
'nhoward@example.net'
'juancampos@example.net'
'vanessa89@example.org'

slug(value: str | None = None) → str¶

Django algorithm

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.slug()
...
'three-image-son'
'kitchen-amount'
'much-mention'
'why-step-themselves'
'me-help-past-wait'

tld() → str¶

Examples:

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

uri(schemes: List[str] | None = None, deep: int | None = None) → str¶

Parameters:

schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https uris. Passing an empty list will result in schemeless uri generation like “://domain.com/index.html”.
deep – an integer specifying how many path components the URI should have..

Returns:

a random url string.

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://hull-gallegos.info/categorylogin.jsp'
'https://www.mcgrath.com/main/main/mainprivacy.htm'
'http://www.woods.net/search/categories/categoryhomepage.htm'
'http://www.snyder.com/list/blog/postsabout.html'
'http://www.miller.net/wp-content/posts/mainlogin.jsp'

uri_extension() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_extension()
...
'.php'
'.php'
'.html'
'.htm'
'.asp'

uri_page() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri_page()
...
'author'
'category'
'privacy'
'category'
'index'

uri_path(deep: int | None = None) → str¶

Examples:

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

url(schemes: List[str] | None = None) → str¶

Parameters:: schemes – a list of strings to use as schemes, one will chosen randomly. If None, it will generate http and https urls. Passing an empty list will result in schemeless url generation like “://domain.com”.
Returns:: a random url string.
Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.url()
...
'https://green.info/'
'https://howard-snow.com/'
'http://campos.com/'
'http://blair.com/'
'https://www.hamilton-carr.com/'

user_name() → str¶

Examples:

>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.user_name()
...
'achang'
'greenwilliam'
'thull'
'nhoward'
'juancampos'

`faker.providers.internet`¶

Table of Contents

Previous topic

Next topic

This Page

faker.providers.internet¶

`faker.providers.internet`¶