Creating images

Creating images for testing can be a challenging task. The goal of this library is to help you out with basic tasks. You can easily generate very basic graphic images (no custom shapes).

If you don’t like how image files are generated by this library, you can check the faker-file package, which can produce complex images.

Supported image formats

Currently, 7 image formats are supported:

  • PNG

  • SVG

  • BMP

  • GIF

  • TIF

  • PPM

  • JPG

Generating images as bytes

See the following fully functional snippet for generating a PNG image.

from fake import FAKER

png_bytes = FAKER.png()

See the full example here

The generated PNG image will be an image filled with a given colour of a size 100x100 px.

If you want an image of a different size or colour, provide size (width, height: Tuple[int, int]) or color (RGB tuple: Tuple[int, int, int]) arguments. See the example below:

png_bytes = FAKER.png(size=(500, 500), color=(127, 127, 127))

See the full example here

Generating files

Generate a PNG image.

png_file = FAKER.png_file()

See the full example here

With size and color tweaks:

png_file = FAKER.png_file(size=(500, 500), color=(127, 127, 127))

See the full example here

All other image formats (SVG, BMP, GIF, TIF, PPM and JPG) work in exactly the same way.

The only format that slightly deviates from others is JPG. Produced JPG images are still rectangles, but unlike all others, instead of being filled with a single solid colour, they are filled with a mixture of colours, based on a chosen base colour. Also, colours on the JPG image are not precise, but a closest match to the colour given.

The following code will generate a 10x10 px square filled with a solid yellow colour.

from fake import FAKER

FAKER.jpg_file(size=(10, 10), color=(182, 232, 90))

While the following code will generate a 640x480 px square filled with yellow and other colours.

from fake import FAKER

FAKER.jpg_file(size=(640, 480), color=(18, 52, 185))

The only colour that always stays solid is the default colour - gray (128, 128, 128).

from fake import FAKER

FAKER.jpg_file(size=(720, 540))