imageunblur-preflight 0.1.0__tar.gz

imageunblur_preflight-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imageunblur-preflight contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imageunblur_preflight-0.1.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: imageunblur-preflight
+Version: 0.1.0
+Summary: Check image file metadata against Image Unblur upload limits locally
+License-Expression: MIT
+Project-URL: Homepage, https://imageunblur.ai/
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow<13,>=10
+Dynamic: license-file
+
+# Image Unblur Preflight
+
+Inspect a local image's format, byte size, dimensions, and frame count before uploading it. The check reflects the website's published limits: JPG/PNG/WebP, up to 20 MB and 24 megapixels, and 64–16,384 pixels per side. It does not evaluate sharpness or send an image anywhere.
+
+```bash
+pip install imageunblur-preflight
+imageunblur-preflight blurry-photo.jpg
+```
+
+Inspect the original at full size before choosing an enhancement model. For eligible files, [unblur image online](https://imageunblur.ai/) offers a browser workflow; compare its output with the original, especially around faces, text, and fine edges. A sharper generated image cannot prove that missing detail was originally present.
+
+Check the official site for current upload limits before relying on this package in an automated workflow.

imageunblur_preflight-0.1.0/README.md

@@ -0,0 +1,12 @@
+# Image Unblur Preflight
+
+Inspect a local image's format, byte size, dimensions, and frame count before uploading it. The check reflects the website's published limits: JPG/PNG/WebP, up to 20 MB and 24 megapixels, and 64–16,384 pixels per side. It does not evaluate sharpness or send an image anywhere.
+
+```bash
+pip install imageunblur-preflight
+imageunblur-preflight blurry-photo.jpg
+```
+
+Inspect the original at full size before choosing an enhancement model. For eligible files, [unblur image online](https://imageunblur.ai/) offers a browser workflow; compare its output with the original, especially around faces, text, and fine edges. A sharper generated image cannot prove that missing detail was originally present.
+
+Check the official site for current upload limits before relying on this package in an automated workflow.

imageunblur_preflight-0.1.0/imageunblur_preflight.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: imageunblur-preflight
+Version: 0.1.0
+Summary: Check image file metadata against Image Unblur upload limits locally
+License-Expression: MIT
+Project-URL: Homepage, https://imageunblur.ai/
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow<13,>=10
+Dynamic: license-file
+
+# Image Unblur Preflight
+
+Inspect a local image's format, byte size, dimensions, and frame count before uploading it. The check reflects the website's published limits: JPG/PNG/WebP, up to 20 MB and 24 megapixels, and 64–16,384 pixels per side. It does not evaluate sharpness or send an image anywhere.
+
+```bash
+pip install imageunblur-preflight
+imageunblur-preflight blurry-photo.jpg
+```
+
+Inspect the original at full size before choosing an enhancement model. For eligible files, [unblur image online](https://imageunblur.ai/) offers a browser workflow; compare its output with the original, especially around faces, text, and fine edges. A sharper generated image cannot prove that missing detail was originally present.
+
+Check the official site for current upload limits before relying on this package in an automated workflow.

imageunblur_preflight-0.1.0/imageunblur_preflight.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+imageunblur_preflight.py
+pyproject.toml
+imageunblur_preflight.egg-info/PKG-INFO
+imageunblur_preflight.egg-info/SOURCES.txt
+imageunblur_preflight.egg-info/dependency_links.txt
+imageunblur_preflight.egg-info/entry_points.txt
+imageunblur_preflight.egg-info/requires.txt
+imageunblur_preflight.egg-info/top_level.txt

imageunblur_preflight-0.1.0/imageunblur_preflight.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

imageunblur_preflight-0.1.0/imageunblur_preflight.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+imageunblur-preflight = imageunblur_preflight:main

imageunblur_preflight-0.1.0/imageunblur_preflight.egg-info/requires.txt

@@ -0,0 +1 @@
+Pillow<13,>=10

imageunblur_preflight-0.1.0/imageunblur_preflight.egg-info/top_level.txt

@@ -0,0 +1 @@
+imageunblur_preflight

imageunblur_preflight-0.1.0/imageunblur_preflight.py

@@ -0,0 +1,55 @@
+"""Check local image metadata before using an online image enhancement tool."""
+
+import argparse
+import json
+from pathlib import Path
+
+
+SUPPORTED = {"JPEG", "PNG", "WEBP"}
+MAX_BYTES = 20_000_000
+MAX_PIXELS = 24_000_000
+
+
+def check_metadata(image_format: str, size_bytes: int, width: int, height: int, frames: int = 1) -> dict:
+    errors = []
+    normalized = image_format.upper()
+    if normalized not in SUPPORTED:
+        errors.append("Use JPG, PNG, or WebP")
+    if size_bytes < 0 or size_bytes > MAX_BYTES:
+        errors.append("File must be at most 20 MB")
+    if not (64 <= width <= 16384 and 64 <= height <= 16384):
+        errors.append("Each side must be between 64 and 16,384 pixels")
+    if width * height > MAX_PIXELS:
+        errors.append("Image must be at most 24 megapixels")
+    if frames != 1:
+        errors.append("Animated or multi-frame images are not supported")
+    return {"accepted_by_published_limits": not errors, "format": normalized,
+            "size_bytes": size_bytes, "width": width, "height": height,
+            "megapixels": round(width * height / 1_000_000, 2), "frames": frames, "errors": errors}
+
+
+def inspect_file(path: str) -> dict:
+    from PIL import Image
+
+    target = Path(path)
+    with Image.open(target) as image:
+        result = check_metadata(image.format or "unknown", target.stat().st_size,
+                                image.width, image.height, getattr(image, "n_frames", 1))
+    result["file"] = str(target)
+    return result
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("image_file")
+    args = parser.parse_args(argv)
+    try:
+        report = inspect_file(args.image_file)
+    except (OSError, ValueError) as exc:
+        parser.error(str(exc))
+    print(json.dumps(report, indent=2))
+    return 0 if report["accepted_by_published_limits"] else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

imageunblur_preflight-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "imageunblur-preflight"
+version = "0.1.0"
+description = "Check image file metadata against Image Unblur upload limits locally"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+dependencies = ["Pillow>=10,<13"]
+classifiers = ["Programming Language :: Python :: 3", "Environment :: Console", "Topic :: Multimedia :: Graphics"]
+
+[project.urls]
+Homepage = "https://imageunblur.ai/"
+
+[project.scripts]
+imageunblur-preflight = "imageunblur_preflight:main"
+
+[tool.setuptools]
+py-modules = ["imageunblur_preflight"]

imageunblur_preflight-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+