faker.providers.internet

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

Bases: faker.providers.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'
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.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: Optional[str] = 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'
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) → str

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

Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.image_url()
...
'https://www.lorempixel.com/788/861'
'https://placeimg.com/530/995/any'
'https://placekitten.com/621/976'
'https://placekitten.com/447/285'
'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()
...
'achang@example.org'
'tammy76@example.com'
'nhoward@example.net'
'juancampos@example.net'
'vanessa89@example.org'
slug(value: Optional[str] = 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() → str
Examples:
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.uri()
...
'https://www.sheppard-tucker.com/category/list/main/'
'http://campos.com/explore/posts/list/post.html'
'https://garcia.com/'
'https://green.com/explore/author.php'
'https://cross.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://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'