Recipes

Imports and initialization

from fake import FAKER

first_name

Returns a random first name.

from fake import FAKER

FAKER.first_name()

last_name

Returns a random last name.

from fake import FAKER

FAKER.last_name()

name

Returns a random full name.

from fake import FAKER

FAKER.name()

word

Returns a random word.

from fake import FAKER

FAKER.word()

words

Returns a list of nb random words.

from fake import FAKER

FAKER.words()

Arguments:

nb (type: int, default value: 5) is an optional argument.

Example with arguments (returns a list of 10 words):

from fake import FAKER

FAKER.words(nb=10)

sentence

Returns a random sentence with nb_words number of words.

from fake import FAKER

FAKER.sentence()

Arguments:

nb_words (type: int, default value: 5) is an optional argument.

Example with arguments (returns a sentence of 10 words):

from fake import FAKER

FAKER.sentence(nb_words=10)

sentences

Returns nb number of random sentences.

from fake import FAKER

FAKER.sentences()

Arguments:

nb (type: int, default value: 3) is an optional argument.

Example with arguments (returns a list of 10 sentences):

from fake import FAKER

FAKER.sentences(nb=10)

paragraph

Returns a random paragraph with nb_sentences number of sentences.

from fake import FAKER

FAKER.paragraph()

Arguments:

nb_sentences (type: int, default value: 5) is an optional argument.

Example with arguments (returns a paragraph of 10 sentences):

from fake import FAKER

FAKER.paragraph(nb_sentences=10)

paragraphs

Returns nb number of random paragraphs.

from fake import FAKER

FAKER.paragraphs()

Arguments:

nb (type: int, default value: 3) is an optional argument.

Example with arguments (returns a list of 10 paragraphs):

from fake import FAKER

FAKER.paragraphs(nb=10)

text

Returns random text with up to nb_chars characters.

from fake import FAKER

FAKER.text()

Arguments:

nb_chars (type: int, default value: 200) is an optional argument.

Example with arguments (returns a 1000 character long text):

from fake import FAKER

FAKER.text(nb_chars=1_000)

texts

Returns nb number of random texts.

from fake import FAKER

FAKER.texts()

Arguments:

nb (type: int, default value: 3) is an optional argument.

Example with arguments (returns a list of 10 texts):

from fake import FAKER

FAKER.texts(nb=10)

file_name

Returns a random file name with the given extension.

from fake import FAKER

FAKER.file_name()

Arguments:

extension (type: str, default value: txt) is an optional argument.

Example with arguments (returns a filename with “png” extension):

from fake import FAKER

FAKER.file_name(extension="png")

email

Returns a random email with the specified domain.

from fake import FAKER

FAKER.email()

Arguments:

domain (type: str, default value: example.com) is an optional argument.

Example with arguments (returns an email with “gmail.com” domain):

from fake import FAKER

FAKER.email(domain="gmail.com")

url

Returns a random URL.

from fake import FAKER

FAKER.url()

Arguments:

protocols (type: Optional[Tuple[str]], default value: None) is an optional argument.
tlds (type: Optional[Tuple[str]], default value: None) is an optional argument.
suffixes (type: Optional[Tuple[str]], default value: None) is an optional argument.

Returns a valid random image URL.

from fake import FAKER

FAKER.image_url()

Arguments:

width (type: int, default value: 800) is a required argument.
height (type: int, default value: 600) is an required argument.
service_url (type: Optional[str], default value: None) is an optional argument.

Example with arguments (alternative dimensions):

from fake import FAKER

FAKER.image_url(width=640, height=480)

pyint

Returns a random integer between min_value and max_value.

from fake import FAKER

FAKER.pyint()

Arguments:

min_value (type: int, default value: 0) is an optional argument.
max_value (type: int, default value: 9999) is an optional argument.

Example with arguments (returns an integer between 0 and 100):

from fake import FAKER

FAKER.pyint(min_value=0, max_value=100)

pybool

Returns a random boolean value.

from fake import FAKER

FAKER.pybool()

pystr

Returns a random string of nb_chars length.

from fake import FAKER

FAKER.pystr()

Arguments:

nb_chars (type: int, default value: 20) is an optional argument.

Example with arguments (returns a string of 64 characters):

from fake import FAKER

FAKER.pystr(nb_chars=64)

pyfloat

Returns a random float between min_value and max_value.

from fake import FAKER

FAKER.pyfloat()

Arguments:

min_value (type: float, default value: 0.0) is an optional argument.
max_value (type: float, default value: 10.00) is an optional argument.

Example with arguments (returns a float between 0 and 100):

from fake import FAKER

FAKER.pyfloat(min_value=0.0, max_value=100.0)

pydecimal

Returns a random decimal, according to given left_digits and right_digits.

from fake import FAKER

FAKER.pydecimal()

Arguments:

left_digits (type: int, default value: 5) is an optional argument.
right_digits (type: int, default value: 2) is an optional argument.
positive (type: bool, default value: True) is an optional argument.

Example with arguments:

from fake import FAKER

FAKER.pydecimal(left_digits=1, right_digits=4, positive=False)

ipv4

Returns a random IPv4 address.

from fake import FAKER

FAKER.ipv4()

date

Generates a random date.

from fake import FAKER

FAKER.date()

Arguments:

start_date (type: str, default value: -7d) is a optional argument.
end_date (type: str, default value: +0d) is an optional argument.

Example with arguments, generate a random date between given start_date and end_date:

from fake import FAKER

FAKER.date(start_date="-1d", end_date="+1d")

date_time

Generates a random datetime.

from fake import FAKER

FAKER.date_time()

Arguments:

start_date (type: str, default value: -7d) is an optional argument.
end_date (type: str, default value: +0d) is an optional argument.

Example with arguments, generate a random date between given start_date and end_date:

from fake import FAKER

FAKER.date_time(start_date="-1d", end_date="+1d")

pdf

Generates a content (bytes) of a PDF document.

from fake import FAKER

FAKER.pdf()

Arguments:

nb_pages (type: int, default value: 1) is an optional argument.
texts (type: List[str], default value: None) is an optional argument.
generator (type: Union[Type[TextPdfGenerator], Type[GraphicPdfGenerator]], default value: GraphicPdfGenerator) is an optional argument.
metadata (type: MetaData, default value: None) is an optional argument.

Note

texts is valid only in case TextPdfGenerator is used.

Note

Either nb_pages or texts shall be provided. nb_pages is by default set to 1, but if texts is given, the value of nb_pages is adjusted accordingly.

Examples with arguments.

Generate a content (bytes) of a PDF document of 100 pages with random graphics:

from fake import FAKER

FAKER.pdf(nb_pages=100)

Generate a content (bytes) of a PDF document of 100 pages with random texts:

from fake import FAKER
from fake import TextPdfGenerator

FAKER.pdf(nb_pages=100, generator=TextPdfGenerator)

If you want to get insights of the content used to generate the PDF (texts), pass the metadata argument.

from fake import FAKER
from fake import MetaData, TextPdfGenerator

metadata = MetaData()
FAKER.pdf(nb_pages=100, generator=TextPdfGenerator, metadata=metadata)

print(metadata.content)  # Inspect ``metadata``

image

Generates a content (bytes) of a image of the specified format and colour.

from fake import FAKER

FAKER.image()  # Supported formats are `png`, `svg`, `bmp` and `gif`

Arguments:

image_format (type: str, default value: png) is an optional argument.
size (type: Tuple[int, int], default value: (100, 100)) is an optional argument.
color (type: Tuple[int, int, int], default value: (0, 0, 255)) is an optional argument.

Example with arguments.

from fake import FAKER

FAKER.image(
    image_format="svg",  # SVG format
    size=(640, 480),  # 640px width, 480px height
    color=(0, 0, 0),  # Fill rectangle with black
)

docx

Generates a content (bytes) of a DOCX document.

from fake import FAKER

FAKER.docx()

Arguments:

nb_pages (type: int, default value: 1) is an optional argument.
texts (type: List[str], default value: None) is an optional argument.

Note

Either nb_pages or texts shall be provided. nb_pages is by default set to 1, but if texts is given, the value of nb_pages is adjusted accordingly.

Examples with arguments.

Generate a content (bytes) of a DOCX document of 100 pages with random texts:

from fake import FAKER

FAKER.docx(nb_pages=100)

If you want to get insights of the content used to generate the DOCX (texts), pass the metadata argument.

from fake import FAKER
from fake import MetaData

metadata = MetaData()
FAKER.docx(nb_pages=100, metadata=metadata)

print(metadata.content)  # Inspect ``metadata``

pdf_file

Generates a PDF file.

from fake import FAKER

FAKER.pdf_file()

Arguments:

Note

Accepts all arguments of pdf + the following:

storage (type: BaseStorage, default value: None) is an optional argument.
basename (type: str, default value: None) is an optional argument.
prefix (type: str, default value: None) is an optional argument.

Examples with arguments.

Generate a PDF document of 100 pages with random graphics:

from fake import FAKER

FAKER.pdf_file(nb_pages=100)

Generate a PDF document of 100 pages with random texts:

from fake import FAKER
from fake import TextPdfGenerator

FAKER.pdf_file(nb_pages=100, generator=TextPdfGenerator)

If you want to get insights of the content used to generate the PDF (texts), pass the metadata argument.

from fake import FAKER
from fake import MetaData, TextPdfGenerator

metadata = MetaData()
FAKER.pdf_file(nb_pages=100, generator=TextPdfGenerator, metadata=metadata)

print(metadata.content)  # Inspect ``metadata``

png_file

Generates a PNG file.

from fake import FAKER

FAKER.png_file()

Arguments:

Note

Accepts all arguments of png + the following:

storage (type: BaseStorage, default value: None) is an optional argument.
basename (type: str, default value: None) is an optional argument.
prefix (type: str, default value: None) is an optional argument.

Example with arguments.

from fake import FAKER

FAKER.png_file(
    basename="png_file",  # Basename
    size=(640, 480),  # 640px width, 480px height
    color=(0, 0, 0),  # Fill rectangle with black
)

svg_file

Generates an SVG file.

from fake import FAKER

FAKER.svg_file()

Arguments:

Note

Accepts all arguments of svg + the following:

storage (type: BaseStorage, default value: None) is an optional argument.
basename (type: str, default value: None) is an optional argument.
prefix (type: str, default value: None) is an optional argument.

Example with arguments.

from fake import FAKER

FAKER.svg_file(
    basename="svg_file",  # Basename
    size=(640, 480),  # 640px width, 480px height
    color=(0, 0, 0),  # Fill rectangle with black
)

bmp_file

Generates a BMP file.

from fake import FAKER

FAKER.bmp_file()

Arguments:

Note

Accepts all arguments of bmp + the following:

storage (type: BaseStorage, default value: None) is an optional argument.
basename (type: str, default value: None) is an optional argument.
prefix (type: str, default value: None) is an optional argument.

Example with arguments.

from fake import FAKER

FAKER.bmp_file(
    basename="bmp_file",  # Basename
    size=(640, 480),  # 640px width, 480px height
    color=(0, 0, 0),  # Fill rectangle with black
)

gif_file

Generates a GIF file.

from fake import FAKER

FAKER.gif_file()

Arguments:

Note

Accepts all arguments of gif + the following:

storage (type: BaseStorage, default value: None) is an optional argument.
basename (type: str, default value: None) is an optional argument.
prefix (type: str, default value: None) is an optional argument.

Example with arguments.

from fake import FAKER

FAKER.gif_file(
    basename="gif_file",  # Basename
    size=(640, 480),  # 640px width, 480px height
    color=(0, 0, 0),  # Fill rectangle with black
)

txt_file

Generates a TXT file.

from fake import FAKER

FAKER.txt_file()

Arguments:

Note

Accepts all arguments of text + the following:

storage (type: BaseStorage, default value: None) is an optional argument.
basename (type: str, default value: None) is an optional argument.
prefix (type: str, default value: None) is an optional argument.

Example with arguments.

from fake import FAKER

FAKER.txt_file(
    basename="txt_file",  # Basename
    nb_chars=10_000,  # 10_000 characters long
)