Metadata-Version: 2.1
Name: python-image-complete
Version: 0.0.6
Summary: Python3 library for checking whether images are complete.
Home-page: https://github.com/waikato-datamining/python-image-complete
Author: Peter Reutemann
Author-email: fracpete@waikato.ac.nz
License: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Multimedia :: Graphics
Classifier: Programming Language :: Python :: 3
License-File: LICENSE

The **python-image-complete** package allows you to check for various
image types to check whether the image is complete or not. For doing
this, it looks for EOF (end of file) markers in the files or compares
the stored file length against the actual file length.

Can also operate on bytes or BytesIO objects.

By default, the library operates in **strict** mode, i.e., no trailing junk data
is tolerated. However, by supplying the parameters `strict` and `check_size` this
can turned into **lenient** mode. The parameter `check_size` (i.e., the number of
bytes to read from the end of the file) is only used for formats gif, jpg, png.

Supported file formats:

* BMP (extension: .bmp)
* GIF (extension: .gif)
* JPG (extension: .jpg, .jpeg)
* PNG (extension: .png)
* WebP (extension: .webp)


Changelog
=========

0.0.6 (2026-03-02)
------------------

- switched to underscores in project name
- approved astro-jingtao's PR that enhances the image type detection and validation logic (https://github.com/waikato-datamining/python-image-complete/pull/3)


0.0.5 (2023-04-17)
------------------

- added support for *lenient mode* via `strict` and `check_size` parameters


0.0.4 (2023-03-30)
------------------

- added support for determining completeness of bytes or BytesIO objects rather than just file names
- added `is_XYZ` methods that determine whether a file/bytes/BytesIO represents file type `XYZ`


0.0.3 (2023-03-28)
------------------

- added support for: WebP


0.0.2 (2020-01-13)
------------------

- added support for: BMP


0.0.1 (2019-04-17)
------------------

- initial release
- support for: GIF, JPG, PNG
