pyimgrid

Generates a grid image from an input image.

Installation

pip install pyimgrid

Usage

from pyimgrid import create_image

create_image(
    src='input.png',
    dst='output.png',
    cols=3,
    rows=2,
    gap=5,
)

Parameters

src (str): Path to the input image.
dst (str): Path to save the generated image.
cols (int): Number of columns in the grid.
rows (int): Number of rows in the grid.
gap (int): Spacing in pixels between images (and around the edges).
bg (str | tuple | None, default None): Background color.
- None: defaults to white (#ffffff), or transparent if dst is a .png file.
- str: a color in any format accepted by Pillow (e.g. '#ffffff').
- tuple: an RGBA tuple (e.g. (0, 0, 0, 0)).

License

MIT

Metadata

Release files for pyimgrid 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyimgrid 0.1.2
File	Size	Uploaded	Provenance
pyimgrid-0.1.2.tar.gz	14.5 kB	Jul 26, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyimgrid 0.1.2
File	Interpreter	ABI	Platform	Reset
pyimgrid-0.1.2-py3-none-any.whl 14.6 kB Jul 26, 2026 Without provenance	Python 3	none	any	Details

Total release size: 29.2 kB

Release files / pyimgrid-0.1.2.tar.gz

Download URL	pyimgrid-0.1.2.tar.gz
Size	14.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`cd4ce6cd96809a0dca7b330442b5eb41b53409da1e54c595c654bdb2b91cff73`
BLAKE2b-256 checksum How to use checksums	`cac0c2403a0b66b98e9c538ffeecb7dbdb9bc1f897d262f98977b4f47de30964`
Upload date	Jul 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.9.20`

Release files / pyimgrid-0.1.2-py3-none-any.whl

Download URL	pyimgrid-0.1.2-py3-none-any.whl
Size	14.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`da46d52b306de8f2fedd732504aebffd9c9731019d42c266fda4037390aa37da`
BLAKE2b-256 checksum How to use checksums	`7f9a9d62240633770425b98dd250ed46978a3c4168b10adb881e65ab2e8afa0a`
Upload date	Jul 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.9.20`

Security for pyimgrid 0.1.2

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.