Faker

https://faker.readthedocs.io/en/stable/
Admin
Faker is a Python package that generates fake data for you, whether to bootstrap a database, create...
Tokens:1,098,369
Snippets:6,459
Trust Score:8.3
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### domain_name() examples

Source: https://faker.readthedocs.io/en/stable/locales/ro_RO.html

Produces domain names with optional subdomain levels. The first example shows default and two-level domains; the second shows five seeded examples.

```python
>>> domain_name()
nichols-phillips.com
>>> domain_name(2)
williamson-hopkins.jackson.com
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'nistor.ro'
'nistor.com'
'eftimie.ro'
'ionescu.ro'
'georgescu.ro'
```

--------------------------------

### hostname() examples

Source: https://faker.readthedocs.io/en/stable/locales/en_PH.html

Shows two usage examples: one without arguments and one with a subdomain level argument. The first example produces a single domain, the second produces a domain with two subdomain levels.

```python
>>> hostname()
db-01.nichols-phillips.com
>>> hostname(0)
laptop-56
>>> hostname(2)
web-12.williamson-hopkins.jackson.com
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.yzv.org.ph'
'desktop-75.snowunion.net'
'desktop-21.greatmillennium.com'
'email-15.csmshipping.net.ph'
'srv-87.gcccapital.net.ph'
```

--------------------------------

### domain_name() examples

Source: https://faker.readthedocs.io/en/stable/locales/en_PH.html

Shows two usage examples: one without arguments and one with a subdomain level argument. The first example produces a single domain, the second produces a domain with two subdomain levels.

```python
>>> domain_name()
nichols-phillips.com
>>> domain_name(2)
williamson-hopkins.jackson.com
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'pclresorts.ph'
'fsgresorts.net'
'ngfinance.com.ph'
'patrickmillennium.com'
'dsdholdings.ph'
```

--------------------------------

### prefix() example

Source: https://faker.readthedocs.io/en/stable/locales/en_IE.html

Generates a random name prefix. The example seeds Faker with 0 and prints five prefixes.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'Dr.'
'Dr.'
'Dr.'
'Dr.'
'Ms.'
```

--------------------------------

### email() example

Source: https://faker.readthedocs.io/en/stable/locales/fr_FR.html

Generates an email address. Example output shows five generated addresses after seeding with Faker.seed(0).

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.email()
...
'athierry@example.org'
'danielle76@example.com'
'lpelletier@example.org'
'rolandjoly@example.org'
'elisabeth92@example.com'
```

--------------------------------

### Generate http_method examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Generates five random HTTP methods (e.g., GET, POST, OPTIONS).

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

--------------------------------

### prefix() example

Source: https://faker.readthedocs.io/en/stable/locales/hi_IN.html

Generates a random prefix in Hindi. The example seeds the Faker generator and prints five prefixes.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.prefix()
...
'संमानित'
'संमानित'
'माननीय'
'सम्मानसूचक'
'आदरवाचक'
```

--------------------------------

### date_time() example

Source: https://faker.readthedocs.io/en/stable/locales/hi_IN.html

Example for date_time() with default parameters. Uses Faker.seed(0) and prints five datetime objects.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 11, 18, 13, 45, 18, 693897)
datetime.datetime(2012, 12, 23, 18, 30, 30, 227477)
datetime.datetime(1993, 11, 6, 8, 1, 47, 260625)
datetime.datetime(1984, 9, 6, 8, 22, 18, 432484)
datetime.datetime(1998, 12, 28, 20, 39, 24, 264133)
```

--------------------------------

### latlng() example

Source: https://faker.readthedocs.io/en/stable/locales/de_AT.html

Generates a random latitude and longitude tuple. The example seeds Faker and prints five lat/lng pairs.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latlng()
...
(Decimal('13.4134995'), Decimal('45.792650'))
(Decimal('-79.132557'), Decimal('-40.995129'))
(Decimal('47.244262'), Decimal('80.880444'))
(Decimal('18.6986795'), Decimal('-17.160223'))
(Decimal('37.935520'), Decimal('12.226293'))

```

--------------------------------

### name() example

Source: https://faker.readthedocs.io/en/stable/locales/en_IE.html

Generates a random full name. The example seeds Faker with 0 and prints five names.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'Dr. Ruth Monagle'
'Fergal Sayers'
'Iona Lynch'
'Frances Hastie'
'Cara Landa'
```

--------------------------------

### random_int example output

Source: https://faker.readthedocs.io/en/stable/providers/baseprovider.html

Example output for random_int with default step=1, showing five random integers between 0 and 15.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.random_int(min=0, max=15)
...
12
13
1
15
8
```

--------------------------------

### latitude() example

Source: https://faker.readthedocs.io/en/stable/locales/de_AT.html

Generates a random latitude value. The example seeds Faker and prints five latitudes.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.latitude()
...
Decimal('13.4134995')
Decimal('22.896325')
Decimal('-79.132557')
Decimal('-20.4975645')
Decimal('47.244262')

```

--------------------------------

### date_time() example

Source: https://faker.readthedocs.io/en/stable/locales/en_PH.html

Example showing date_time() with default parameters, returning a random datetime between January 1, 1970 and now.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time()
...
datetime.datetime(2017, 11, 18, 13, 44, 48, 294710)
datetime.datetime(2012, 12, 23, 18, 30, 2, 941118)
datetime.datetime(1993, 11, 6, 8, 1, 32, 120048)
datetime.datetime(1984, 9, 6, 8, 22, 9, 111481)
datetime.datetime(1998, 12, 28, 20, 39, 5, 858243)
```

--------------------------------

### first_name() example

Source: https://faker.readthedocs.io/en/stable/locales/en_IE.html

Generates a random first name. The example seeds Faker with 0 and prints five names.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.first_name()
...
'Cailin'
'Tia'
'Ciara'
'Cailum'
'Piaras'
```

--------------------------------

### image_url() example

Source: https://faker.readthedocs.io/en/stable/locales/fr_CH.html

Returns a URL to a placeholder image, e.g., http://placehold.it/640x480. The example shows the output of calling image_url().

```python
>>> image_url()
'http://placehold.it/640x480'
```

--------------------------------

### am_pm() example

Source: https://faker.readthedocs.io/en/stable/locales/az_AZ.html

Generates a random 'AM' or 'PM' string. The example seeds the Faker and prints five values.

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

```

--------------------------------

### name() example

Source: https://faker.readthedocs.io/en/stable/locales/hi_IN.html

Generates a random full name in Hindi. The example seeds the Faker generator and prints five names.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.name()
...
'संमानित अरुणा सेनगुप्ता'
'इन्दिरा मैतीजी'
'सम्मानसूचक पद्म आहूजा'
'जितेन्द्र मुख़र्जीजी'
'रति रोद्रिगुएस'
```

--------------------------------

### date_between() examples

Source: https://faker.readthedocs.io/en/stable/locales/fr_FR.html

Returns a date object between two given dates. The first example uses default dates, the second uses a relative start date, and the third uses both relative start and end dates.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between()
...
datetime.date(2015, 3, 12)
datetime.date(2015, 3, 12)
datetime.date(2015, 3, 12)
datetime.date(2015, 3, 12)
datetime.date(2015, 3, 12)

```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1w')
...
datetime.date(2015, 3, 5)
datetime.date(2015, 3, 5)
datetime.date(2015, 3, 5)
datetime.date(2015, 3, 5)
datetime.date(2015, 3, 5)

```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_between(start_date='-1y', end_date='+1w')
...
datetime.date(2014, 3, 12)
datetime.date(2014, 3, 12)
datetime.date(2014, 3, 12)
datetime.date(2014, 3, 12)
datetime.date(2014, 3, 12)

```

--------------------------------

### Faker military_ship() example

Source: https://faker.readthedocs.io/en/stable/locales/en_US.html

Generates a random military ship prefix. The example seeds the generator and prints five prefixes.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.military_ship()
...
'USCGC'
'USCGC'
'USS'
'USNV'
'USCGC'
```

--------------------------------

### start_digit() example

Source: https://faker.readthedocs.io/en/stable/locales/az_AZ.html

Generates a starting digit for a phone number. The example shows five outputs after seeding with Faker.seed(0).

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.start_digit()
...
'8'
'8'
'2'
'6'
'9'
```

--------------------------------

### date_time_between_dates example

Source: https://faker.readthedocs.io/en/stable/locales/ko_KR.html

Example usage of fake.date_time_between_dates() with explicit start and end dates. Demonstrates generating five random datetimes between the specified range.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2022, 1, 14, 0, 8, 26, 236214)
datetime.datetime(2019, 6, 11, 13, 33, 12, 808743)
datetime.datetime(2009, 4, 27, 19, 2, 53, 361449)
datetime.datetime(2004, 6, 21, 12, 13, 29, 49189)
datetime.datetime(2012, 1, 16, 15, 30, 25, 171082)
```

--------------------------------

### pyset() example

Source: https://faker.readthedocs.io/en/stable/providers/faker.providers.python.html

Generates a random set of values of various types. The example seeds the Faker instance and prints five sets.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pyset()
...
{-424604.985946604, 'ppgrVkPCoePqmjQbZndJ', 'NGnVZQUqLUJyfwFVYySn', 'qfErjaoKtiwdOSlQGWFd', 'LuQIazTmqTjDmYPxeqAW', 'TWRUWCuKoQSUEXExIZVP', 663, datetime.datetime(1977, 11, 24, 10, 58, 0, 745124), -9787526.29318886, datetime.datetime(2021, 12, 9, 21, 26, 50, 294365)}
{'paul42@example.net', 'xeMChNzFJEUSgqMReEKi', 'KunVyUDKkNPiiBgVIaJU', datetime.datetime(2022, 1, 10, 7, 18, 17, 969422), 'HtTDvuKvIcxniBzDNTzq', 'catherinejohnston@example.com', 'tYbbXjgkPWbwfnlHsjAc'}
{-958272097856.158, 0.28952549189774, 6016, 'johnsonrobin@example.org', Decimal('-6549903182054842898289740559728455724548119.045229611133060168847793615349263511087317643039213765'), 'https://taylor.com/tag/list/wp-contentcategory.htm', 'QTQjZGeLZuJqlLaQBfgH', 'rGciZpuCpymcjBdurvfV', 4725240091.51995, 'angela59@example.org', datetime.datetime(2016, 11, 22, 11, 27, 15, 237327)}
{'https://www.bolton-reid.com/category/blog/listregister.php', 'https://lloyd-stark.com/main/blog/tagsprivacy.html', 'james71@example.org', datetime.datetime(2018, 10, 16, 3, 49, 12, 226895), datetime.datetime(2004, 7, 29, 18, 44, 10, 476000), Decimal('-74655832342888117024.8091891634896769930024894517446660226279125609767017200992518'), 'aKMqqBTFitpKyPAVdgpN'}
{7424134494689.1, Decimal('-7523546610001610008450701.375825340797034717489'), 'EpsmGHtaYUwtXejffFi', 'vfOMbxJbVYLedsbsaYQd', 'EeBqthglAmjtISFuKgpv', datetime.datetime(2006, 1, 22, 6, 20, 19, 205626), 'OxNxPdcWzUXIDleQUOKv', 'kkJWgatbFSjfrXgYsypW'}
```

--------------------------------

### `faker.providers.date_time.date_time_between`

Source: https://faker.readthedocs.io/en/stable/locales/bn_BD.html

Get a random datetime between the given start and end dates.

```APIDOC
## `faker.providers.date_time.date_time_between`

### Description
Get a random datetime between the given start and end dates.

### Method
N/A (SDK method)

### Endpoint
N/A (SDK method)

### Parameters
- **start_date** (DateParseType) - Optional - Defaults to 30 years ago
- **end_date** (DateParseType) - Optional - Defaults to `"now"`
- **tzinfo** (datetime.tzinfo subclass) - Optional - timezone

### Request Example
```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
```

### Response
#### Success Response
Returns a `datetime` object.

#### Response Example
```
datetime.datetime(2022, 1, 14, 0, 7, 1, 236214)
datetime.datetime(2019, 6, 11, 13, 31, 47, 808743)
datetime.datetime(2009, 4, 27, 19, 1, 28, 361449)
datetime.datetime(2004, 6, 21, 12, 12, 4, 49189)
datetime.datetime(2012, 1, 16, 15, 29, 0, 171082)
```
```

--------------------------------

### future_datetime() example

Source: https://faker.readthedocs.io/en/stable/locales/mk_MK.html

Seeds Faker and prints five datetimes from the future. The end_date parameter defaults to '+30d'; the example uses '+1y' to get dates up to one year ahead.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.future_datetime(end_date='+1y')
...
datetime.datetime(2027, 7, 20, 2, 57, 43, 596785)
datetime.datetime(2027, 6, 18, 13, 0, 33, 235670)
datetime.datetime(2027, 2, 15, 7, 35, 32, 924810)
datetime.datetime(2026, 12, 18, 6, 33, 54, 276056)
datetime.datetime(2027, 3, 20, 10, 40, 27, 894428)
```

--------------------------------

### dga() example

Source: https://faker.readthedocs.io/en/stable/locales/pt_BR.html

Generates a domain name using a domain generation algorithm based on the current date. Example output after seeding with 0 shows five generated domains.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.dga()
...
'hxqvaffcmfsccynscisxeajjagjahtnfcmfsccynscisxeajjagjahtnfcmfscc.org'
'meydkrgdcvulautulqvjofrrnbjkfmvrewtpfttqcjafdhxckmyfamo.com.br'
'rsoitciyjatufbjfquyfvudjerivnsrsprechaalfphoqywwursulakiudm.gov.br'
'ujkyfemsyj.org'
'yastipdtwjouhjjorvdtvxkkhdirblaoisavobsvdnhimwbflybiwimdljso.org'
```

--------------------------------

### date_time_between() example

Source: https://faker.readthedocs.io/en/stable/locales/pt_BR.html

Generates a random datetime between a start date (default 30 years ago) and an end date (default 'now'). The example seeds Faker with 0 and prints five generated datetimes.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between()
...
datetime.datetime(2022, 1, 14, 0, 8, 41, 236214)
datetime.datetime(2019, 6, 11, 13, 33, 27, 808743)
datetime.datetime(2009, 4, 27, 19, 3, 8, 361449)
datetime.datetime(2004, 6, 21, 12, 13, 44, 49189)
datetime.datetime(2012, 1, 16, 15, 30, 40, 171082)
```

--------------------------------

### Multi-line :sample: with size and seed

Source: https://faker.readthedocs.io/en/stable/_sources/writing-docs.rst.txt

Shows how to write a :sample: line with size, seed, and keyword arguments, breaking the keyword arguments across multiple lines as in Python code.

```text
:sample size=25 seed=12345: arg1='very long value, unfortunately',
                    arg2='yet another long value'
```

--------------------------------

### pystr_format() example

Source: https://faker.readthedocs.io/en/stable/providers/faker.providers.python.html

Generates a formatted random string using a template. The example seeds the Faker instance and prints five formatted strings.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pystr_format()
...
'F6-0486311W'
'n4-7596634Y'
'Z4-2198268i'
'U9-2414104I'
'w5-7811208R'
```

--------------------------------

### Generate International Bank Account Number (IBAN)

Source: https://faker.readthedocs.io/en/stable/locales/de_AT.html

Example usage of fake.iban() to generate an IBAN. Outputs a list of strings starting with 'AT'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'AT456604876475938242'
'AT861948924115781565'
'AT929387784080160975'
'AT383513933287115871'
'AT734841858398947196'
```

--------------------------------

### Generate datetimes for the current month with date_time_this_month

Source: https://faker.readthedocs.io/en/stable/locales/sk_SK.html

Generate random datetime objects within the current month. The first example uses default parameters (before_now=True, after_now=False), producing dates from the start of the month up to today. The second example sets before_now=False and after_now=True to generate dates from today to the end of the month. Both examples seed the Faker instance for reproducible output.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2026, 9, 12, 13, 47, 19, 510121)
datetime.datetime(2026, 9, 11, 9, 20, 37, 61904)
datetime.datetime(2026, 9, 6, 18, 21, 18, 296890)
datetime.datetime(2026, 9, 4, 13, 10, 32, 259288)
datetime.datetime(2026, 9, 8, 0, 11, 37, 28495)
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2026, 9, 28, 11, 9, 50, 929032)
datetime.datetime(2026, 9, 27, 1, 21, 9, 750518)
datetime.datetime(2026, 9, 21, 13, 25, 32, 240623)
datetime.datetime(2026, 9, 18, 22, 12, 48, 957472)
datetime.datetime(2026, 9, 23, 0, 53, 36, 49293)
```

--------------------------------

### Generate random hostname examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Demonstrates generating five random hostnames using the bs_BA provider.

```python
Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.green.net.ba'
'laptop-47.silva-odonnell.gov.ba'
'srv-42.montgomery.gov.ba'
'email-92.garcia-jones.unsa.ba'
'email-57.garcia.com.ba'
```

--------------------------------

### date_time_between_dates() with custom start/end

Source: https://faker.readthedocs.io/en/stable/locales/ta_IN.html

Generates a random datetime between the given start and end datetimes. The example seeds the Faker instance and prints five datetimes.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2022, 1, 14, 0, 8, 57, 236214)
datetime.datetime(2019, 6, 11, 13, 33, 43, 808743)
datetime.datetime(2009, 4, 27, 19, 3, 24, 361449)
datetime.datetime(2004, 6, 21, 12, 14, 0, 49189)
datetime.datetime(2012, 1, 16, 15, 30, 56, 171082)
```

--------------------------------

### dsv() example with set_arguments

Source: https://faker.readthedocs.io/en/stable/locales/en_PH.html

Shows how to set arguments for a data column and generate DSV data. The example uses fake.set_arguments() to define a range for the 'top_half' argument, then calls fake.dsv() with data_columns using the '{{ name }}' and '{{ pyint:top_half }}' tokens. Note that the example uses curly quotes and lacks a newline between the two calls, as shown in the source.

```python
fake.set_arguments(‘top_half’, {‘min_value’: 50, ‘max_value’: 100}) fake.dsv(data_columns=(‘{{ name }}’, ‘{{ pyint:top_half }}’))
```

--------------------------------

### Generate Visayas province address with fake.visayas_province_address()

Source: https://faker.readthedocs.io/en/stable/locales/tl_PH.html

Returns a full address from a Visayas province. Seeded for reproducible output. The example is truncated in the source, showing only the setup and call.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.visayas_province_address()
...

```

--------------------------------

### Generate EAN-13 barcodes with leading_zero=True using fake.ean13()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean13() method with leading_zero=True. Seeds the Faker instance and prints five generated EAN-13 barcodes that start with zero.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(leading_zero=True)
...
'0604876475933'
'0219489241150'
'0156593877847'
'0016097535134'
'0287115871484'
```

--------------------------------

### local_latlng() example

Source: https://faker.readthedocs.io/en/stable/locales/de_AT.html

Returns a tuple with latitude, longitude, place name, country code, and timezone for a location on land. The example seeds Faker and prints five such tuples.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.local_latlng()
...
('40.72371', '-73.95097', 'Greenpoint', 'US', 'America/New_York')
('41.48199', '-81.79819', 'Lakewood', 'US', 'America/New_York')
('30.17746', '-81.38758', 'Palm Valley', 'US', 'America/New_York')
('41.72059', '-87.70172', 'Evergreen Park', 'US', 'America/Chicago')
('33.93113', '-117.54866', 'Norco', 'US', 'America/Los_Angeles')

```

--------------------------------

### Generate EAN-13 barcodes with leading_zero=False using fake.ean13()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean13() method with leading_zero=False. Seeds the Faker instance and prints five generated EAN-13 barcodes that do not start with zero.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(leading_zero=False)
...
'7048764759386'
'5194892411572'
'6593877840809'
'7975351393329'
'2587148418587'
```

--------------------------------

### hostname() examples

Source: https://faker.readthedocs.io/en/stable/locales/sk_SK.html

Shows three usage examples: hostname() returns a hostname with one subdomain level, hostname(0) returns a hostname without subdomains, and hostname(2) returns a hostname with two subdomain levels. The second example is followed by a seeded loop generating five random hostnames.

```python
>>> hostname()
db-01.nichols-phillips.com
>>> hostname(0)
laptop-56
>>> hostname(2)
web-12.williamson-hopkins.jackson.com
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.mach.com'
'web-47.chalupkova.com'
'srv-19.feldekova.com'
'db-15.heckova.com'
'desktop-93.bednarikova.com'
```

--------------------------------

### Generate IBAN with fake.iban()

Source: https://faker.readthedocs.io/en/stable/locales/az_AZ.html

Example usage of the iban() method for the az_AZ locale. After seeding with Faker.seed(0), five International Bank Account Numbers are generated, each starting with 'AZ' (e.g., 'AZ86MYNB48764759382421948924').

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.iban()
...
'AZ86MYNB48764759382421948924'
'AZ03DXCV57815659387784080160'
'AZ57TPKH51393328711587148418'
'AZ21KRGZ98947196593423209471'
'AZ96CVYE20186848339694775159'
```

--------------------------------

### Generate email examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Shows generating five email addresses with the safe option (default) using example domains.

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

--------------------------------

### Generate random datetime with fake.date_time_between_dates() custom range

Source: https://faker.readthedocs.io/en/stable/locales/da_DK.html

Generate a random datetime between a custom start and end date using string date expressions. The output shows five example datetimes after seeding.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2022, 1, 14, 0, 7, 8, 236214)
datetime.datetime(2019, 6, 11, 13, 31, 54, 808743)
datetime.datetime(2009, 4, 27, 19, 1, 35, 361449)
datetime.datetime(2004, 6, 21, 12, 12, 11, 49189)
datetime.datetime(2012, 1, 16, 15, 29, 7, 171082)
```

--------------------------------

### Generate EAN-8 barcodes with prefixes=('00',) using fake.ean8()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean8() method with a single prefix tuple. Seeds the Faker instance and prints five generated barcodes that start with '00'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('00', ))
...
'00048767'
'00938242'
'00489249'
'00781565'
'00877848'
```

--------------------------------

### Generate random domain_name examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Demonstrates generating five random domain names using the bs_BA provider.

```python
Faker.seed(0)
>>> for _ in range(5):
...     fake.domain_name()
...
'chang-fisher.org.ba'
'tucker.net.ba'
'silva-odonnell.gov.ba'
'campbell.gov.ba'
'archer-patel.edu.ba'
```

--------------------------------

### Generate EAN-13 barcodes with prefixes=('00',) using fake.ean13()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean13() method with a single prefix tuple. Seeds the Faker instance and prints five generated barcodes that start with '00'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'
```

--------------------------------

### Generate ascii_company_email examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Shows how to produce five ASCII company email addresses using the bs_BA provider.

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

--------------------------------

### Generate EAN barcodes with prefixes=('00',) using fake.ean()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean() method with a single prefix tuple. Seeds the Faker instance and prints five generated barcodes that start with '00'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('00', ))
...
'0004876475931'
'0019489241156'
'0056593877840'
'0016097535134'
'0087115871480'
```

--------------------------------

### Generate datetimes in the current year with date_time_this_year()

Source: https://faker.readthedocs.io/en/stable/locales/ka_GE.html

Seeds the Faker instance and prints five datetime objects from the current year. The example uses before_now=False and after_now=True to get only future dates within the year.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_year(before_now=False, after_now=True)
...
datetime.datetime(2026, 12, 15, 3, 38, 47, 141824)
datetime.datetime(2026, 12, 5, 18, 54, 51, 173378)
datetime.datetime(2026, 10, 30, 6, 2, 35, 977764)
datetime.datetime(2026, 10, 12, 17, 53, 46, 412953)
datetime.datetime(2026, 11, 9, 1, 47, 3, 358925)
```

--------------------------------

### Generate free_email_domain examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Shows generating five free email domains from a list of common providers.

```python
Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email_domain()
...
'outlook.com'
'outlook.com'
'gmail.com'
'yahoo.com'
'bih.net.ba'
```

--------------------------------

### Generate time strings with fake.time()

Source: https://faker.readthedocs.io/en/stable/providers/faker.providers.date_time.html

Use fake.time() to get a random time string in 24h format by default, or with a custom pattern. The first example uses the default pattern; the second passes pattern='%I:%M %p'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time()
...
'13:46:19'
'18:31:24'
'08:02:17'
'08:22:37'
'20:40:01'
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time(pattern='%I:%M %p')
...
'01:46 PM'
'06:31 PM'
'08:02 AM'
'08:22 AM'
'08:40 PM'
```

--------------------------------

### pystr() example

Source: https://faker.readthedocs.io/en/stable/providers/faker.providers.python.html

Generates random strings of upper and lowercase letters. The example seeds the Faker instance and prints five strings.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.pystr()
...
'RNvnAvOpyEVAoNGnVZQU'
'qLUJyfwFVYySnPCaLuQI'
'azTmqTjDmYPxeqAWfCKC'
'QCYFExFuDpjjFIyeNTWR'
'UWCuKoQSUEXExIZVPeFz'
```

--------------------------------

### Generate EAN-8 barcodes with prefixes=('45', '49') using fake.ean8()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean8() method with multiple prefixes. Seeds the Faker instance and prints five generated barcodes that start with either '45' or '49'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean8(prefixes=('45', '49'))
...
'49048766'
'45938245'
'45489242'
'49781564'
'45877841'
```

--------------------------------

### Generate EAN-13 barcodes with prefixes=('45', '49') using fake.ean13()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean13() method with multiple prefixes. Seeds the Faker instance and prints five generated barcodes that start with either '45' or '49'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean13(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'
```

--------------------------------

### Generate IDE numbers

Source: https://faker.readthedocs.io/en/stable/locales/fr_CH.html

Example from the ide method documentation showing how to generate IDE numbers. The output shows five generated IDE numbers after seeding.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ide()
...
'CHE-690.243.519'
'CHE-753.412.801'
'CHE-942.705.619'
'CHE-815.324.971'
'CHE-794.086.521'
```

--------------------------------

### Generate EAN barcodes with prefixes=('45', '49') using fake.ean()

Source: https://faker.readthedocs.io/en/stable/locales/en_CA.html

Example usage of the ean() method with multiple prefixes. Seeds the Faker instance and prints five generated barcodes that start with either '45' or '49'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.ean(prefixes=('45', '49'))
...
'4504876475932'
'4919489241155'
'4556593877841'
'4516097535135'
'4987115871489'
```

--------------------------------

### Generate datetimes in the current month with date_time_this_month()

Source: https://faker.readthedocs.io/en/stable/locales/ka_GE.html

Seeds the Faker instance and prints five datetime objects from the current month. The default behavior includes dates before now, but the second example uses before_now=False and after_now=True to get only future dates within the month.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month()
...
datetime.datetime(2026, 9, 12, 13, 46, 56, 710731)
datetime.datetime(2026, 9, 11, 9, 20, 16, 597135)
datetime.datetime(2026, 9, 6, 18, 21, 6, 941458)
datetime.datetime(2026, 9, 4, 13, 10, 25, 268535)
datetime.datetime(2026, 9, 8, 0, 11, 23, 224077)
```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_this_month(before_now=False, after_now=True)
...
datetime.datetime(2026, 9, 28, 11, 9, 46, 728422)
datetime.datetime(2026, 9, 27, 1, 21, 3, 215286)
datetime.datetime(2026, 9, 21, 13, 25, 16, 596056)
datetime.datetime(2026, 9, 18, 22, 12, 28, 948224)
datetime.datetime(2026, 9, 23, 0, 53, 22, 853710)
```

--------------------------------

### Preprocessed docstring example

Source: https://faker.readthedocs.io/en/stable/_sources/writing-docs.rst.txt

Shows the resulting docstring after preprocessing, where :sample: lines are collected and appended at the end. The example demonstrates the output of a provider method with different seeds.

```python
.. code-block:: python

   # Resulting docstring (more or less) after preprocessing
   def foo():
       """Summary line

       Lorem ipsum dolor sit amet, consectetur adipiscing elit.
       Fusce auctor faucibus condimentum.


       Duis posuere lacinia porta.
       Quisque mauris nisl, mattis sed ornare eget, accumsan sit amet mauris.

       :examples:

       >>> Faker.seed(0)
       >>> for _ in range(5):
       ...     fake.foo()
       ...
       1
       1
       1
       1
       1

       >>> Faker.seed(1000)
       >>> for _ in range(10):
       ...     fake.foo()
       ...
       1
       1
       1
       1
       1
       1
       1
       1
       1
       1
       """
       pass
```

--------------------------------

### Create a custom provider class

Source: https://faker.readthedocs.io/en/stable/index.html

Shows how to create a custom provider by subclassing BaseProvider and adding it to the Faker instance. After adding, the custom method foo() returns 'bar'.

```python
from faker import Faker
fake = Faker()

# first, import a similar Provider or use the default one
from faker.providers import BaseProvider

# create new provider class
class MyProvider(BaseProvider):
    def foo(self) -> str:
        return 'bar'

# then add new provider to faker instance
fake.add_provider(MyProvider)

# now you can use:
fake.foo()
# 'bar'
```

--------------------------------

### Generate company_email examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Demonstrates generating five company email addresses for the bs_BA locale.

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

--------------------------------

### date_time_between_dates() with custom start/end example

Source: https://faker.readthedocs.io/en/stable/locales/hi_IN.html

Example usage of fake.date_time_between_dates() with datetime_start='-30y' and datetime_end='now'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.date_time_between_dates(datetime_start='-30y', datetime_end='now')
...
datetime.datetime(2022, 1, 14, 0, 8, 5, 236214)
datetime.datetime(2019, 6, 11, 13, 32, 51, 808743)
datetime.datetime(2009, 4, 27, 19, 2, 32, 361449)
datetime.datetime(2004, 6, 21, 12, 13, 8, 49189)
datetime.datetime(2012, 1, 16, 15, 30, 4, 171082)
```

--------------------------------

### Generate free_email examples

Source: https://faker.readthedocs.io/en/stable/locales/bs_BA.html

Generates five free email addresses using common providers like gmail, yahoo, and bih.net.ba.

```python
Faker.seed(0)
>>> for _ in range(5):
...     fake.free_email()
...
'achang@gmail.com'
'tammy76@yahoo.com'
'nhoward@bih.net.ba'
'juancampos@bih.net.ba'
'vanessa89@hotmail.com'
```

--------------------------------

### Install Faker with pip

Source: https://faker.readthedocs.io/en/stable/index.html

Command to install the Faker package using pip.

```bash
pip install Faker
```

--------------------------------

### Generate tld examples

Source: https://faker.readthedocs.io/en/stable/locales/pt_BR.html

Seeds Faker with 0 and prints five tld values.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.tld()
...
'com.br'
'br'
'com.br'
'br'
'com'
```

--------------------------------

### time_object() examples

Source: https://faker.readthedocs.io/en/stable/locales/it_IT.html

Generates a random time object. Two examples: default and with end_datetime='+1h'.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object()
...
datetime.time(13, 45, 30, 515802)
datetime.time(18, 30, 40, 838839)
datetime.time(8, 1, 53, 148627)
datetime.time(8, 22, 22, 57318)
datetime.time(20, 39, 31, 421979)

```

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.time_object(end_datetime='+1h')
...
datetime.time(14, 36, 10, 434468)
datetime.time(19, 16, 9, 474689)
datetime.time(8, 27, 7, 206318)
datetime.time(8, 37, 54, 157619)
datetime.time(21, 10, 12, 10976)

```

--------------------------------

### hostname() example with seed

Source: https://faker.readthedocs.io/en/stable/locales/el_GR.html

Generates five hostnames using the Greek locale provider. The output shows the exact hostnames produced after seeding with Faker.seed(0).

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.hostname()
...
'web-66.papadopoulos.gr'
'laptop-47.natsouli-michalellis.com'
'desktop-21.liakou-choleva.com'
'desktop-11.theodoropoulou-mitropoulou.gr'
'laptop-59.mastraggeli-kalamara.gr'

```

--------------------------------

### Generate company names

Source: https://faker.readthedocs.io/en/stable/locales/fr_CH.html

Example from the company method documentation showing how to generate company names. The output shows five generated names after seeding.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.company()
...
'Masseron'
'Cossy Sàrl.'
'Diesbach'
'Grand'
'Pachoud Broquet Sàrl.'
```

--------------------------------

### random_letter example output

Source: https://faker.readthedocs.io/en/stable/providers/baseprovider.html

Example output for random_letter, showing five random lowercase ASCII letters.

```python
>>> Faker.seed(0)
>>> for _ in range(5):
...     fake.random_letter()
...
'y'
'W'
'A'
'c'
'q'
```
Tokens:
Raw