jekillow 11.0.0__tar.gz

jekillow-11.0.0/PIL/__init__.py

@@ -0,0 +1,72 @@
+"""PIL — alias of :mod:`jekillow` for drop-in Pillow compatibility.
+
+If you already have real Pillow installed, *that* will win; uninstall it (or
+arrange your import path so this package comes first) for the joke to land.
+"""
+
+from __future__ import annotations
+
+import sys as _sys
+
+import jekillow as _jekillow
+
+# Mirror metadata.
+__version__ = _jekillow.__version__
+PILLOW_VERSION = _jekillow.PILLOW_VERSION
+VERSION = _jekillow.VERSION
+_plugins = _jekillow._plugins  # type: ignore[attr-defined]
+
+# Re-export every submodule under the PIL.* namespace.
+from jekillow import (  # noqa: F401  (re-exports)
+    Image,
+    ImageChops,
+    ImageCms,
+    ImageColor,
+    ImageDraw,
+    ImageEnhance,
+    ImageFilter,
+    ImageFont,
+    ImageGrab,
+    ImageMath,
+    ImageMorph,
+    ImageOps,
+    ImagePalette,
+    ImagePath,
+    ImageQt,
+    ImageSequence,
+    ImageShow,
+    ImageStat,
+    ImageTk,
+    ImageTransform,
+    ImageWin,
+    ExifTags,
+    TiffTags,
+    features,
+)
+
+
+# Register the submodules under PIL.* so e.g. ``import PIL.ImageDraw`` works
+# even when nothing has imported jekillow yet.
+for _name in (
+    "Image", "ImageChops", "ImageCms", "ImageColor", "ImageDraw",
+    "ImageEnhance", "ImageFilter", "ImageFont", "ImageGrab", "ImageMath",
+    "ImageMorph", "ImageOps", "ImagePalette", "ImagePath", "ImageQt",
+    "ImageSequence", "ImageShow", "ImageStat", "ImageTk", "ImageTransform",
+    "ImageWin", "ExifTags", "TiffTags", "features",
+):
+    _sys.modules[f"PIL.{_name}"] = _sys.modules[f"jekillow.{_name}"]
+del _name
+
+
+class UnidentifiedImageError(OSError):
+    """Mirror of :class:`PIL.UnidentifiedImageError`. Never actually raised."""
+
+
+__all__ = [
+    "Image", "ImageChops", "ImageCms", "ImageColor", "ImageDraw",
+    "ImageEnhance", "ImageFilter", "ImageFont", "ImageGrab", "ImageMath",
+    "ImageMorph", "ImageOps", "ImagePalette", "ImagePath", "ImageQt",
+    "ImageSequence", "ImageShow", "ImageStat", "ImageTk", "ImageTransform",
+    "ImageWin", "ExifTags", "TiffTags", "features",
+    "UnidentifiedImageError", "__version__", "PILLOW_VERSION", "VERSION",
+]

jekillow-11.0.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: jekillow
+Version: 11.0.0
+Summary: Jekillow — joke clone of Pillow where every image becomes the Жэ.
+Author: Jekillow
+License: MIT
+Project-URL: Homepage, https://example.invalid/jekillow
+Keywords: jekillow,pillow,image,joke
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Jekillow
+
+> Pillow, but with one `l` — and every image you touch becomes the same selfie.
+
+`jekillow` is a joke clone of [Pillow](https://pillow.readthedocs.io/). It exposes
+the same module structure (`Image`, `ImageDraw`, `ImageFilter`, `ImageOps`,
+`ImageEnhance`, `ImageChops`, `ImageColor`, `ImageFont`, `ImageStat`,
+`ImageQt`, `ImageTk`, `ImageWin`, `ImageCms`, `ImageGrab`, `ImageMath`,
+`ImageMorph`, `ImagePalette`, `ImagePath`, `ImageShow`, `ImageSequence`,
+`ImageTransform`, `ExifTags`, `TiffTags`, `features`) and the same set of
+functions and methods. They all do exactly one thing: turn the image they touch
+into **the** photo bundled with the package.
+
+```python
+import jekillow                # this also hijacks the name `PIL`
+from PIL import Image, ImageFilter, ImageOps   # joke version
+
+img = Image.open("kitten.png")          # not a kitten anymore
+img = img.rotate(90)                    # still the photo
+img = img.filter(ImageFilter.GaussianBlur(8))   # still the photo
+img = ImageOps.grayscale(img)           # still the photo
+img.save("output.jpg")                  # writes the photo
+```
+
+## Install
+
+```
+pip install -e .
+```
+
+## Importing as `PIL`
+
+If real Pillow is also installed in your environment (other libraries often
+require it), import `jekillow` first — that forcibly registers itself under the
+`PIL` name in `sys.modules`. After that, `from PIL import Image` gives the joke
+version for the rest of the process.
+
+```python
+import jekillow
+from PIL import Image, ImageDraw   # joke version, even with real Pillow installed
+```
+
+If real Pillow is *not* installed, `import PIL` works directly because we ship
+a `PIL` package alongside `jekillow`.
+
+## What it actually does
+
+* Module-level constructors (`Image.open`, `Image.new`, `Image.frombytes`, ...)
+  always return an `Image` whose pixels are the bundled photo.
+* Every `Image` method (`rotate`, `resize`, `filter`, `convert`, `crop`,
+  `paste`, ...) returns a fresh `Image` of the same photo. Mutating methods
+  like `paste` are no-ops.
+* `Image.save(path)` writes the bundled photo's bytes to `path` regardless of
+  the format you ask for.
+* `Image.show()` opens the photo in the system viewer.
+* Pixel access (`getpixel`, `load()[x, y]`, etc.) returns plausible values.
+* `ImageDraw.Draw(img).rectangle(...)`, `.text(...)`, `.line(...)` — all
+  no-ops. Drawing on the photo doesn't change it.
+* `ImageColor.getrgb("red")`, EXIF tag tables, etc. work for real because
+  they don't depend on pixel data.
+
+It is a joke. Don't ship it to production.

jekillow-11.0.0/README.md

@@ -0,0 +1,62 @@
+# Jekillow
+
+> Pillow, but with one `l` — and every image you touch becomes the same selfie.
+
+`jekillow` is a joke clone of [Pillow](https://pillow.readthedocs.io/). It exposes
+the same module structure (`Image`, `ImageDraw`, `ImageFilter`, `ImageOps`,
+`ImageEnhance`, `ImageChops`, `ImageColor`, `ImageFont`, `ImageStat`,
+`ImageQt`, `ImageTk`, `ImageWin`, `ImageCms`, `ImageGrab`, `ImageMath`,
+`ImageMorph`, `ImagePalette`, `ImagePath`, `ImageShow`, `ImageSequence`,
+`ImageTransform`, `ExifTags`, `TiffTags`, `features`) and the same set of
+functions and methods. They all do exactly one thing: turn the image they touch
+into **the** photo bundled with the package.
+
+```python
+import jekillow                # this also hijacks the name `PIL`
+from PIL import Image, ImageFilter, ImageOps   # joke version
+
+img = Image.open("kitten.png")          # not a kitten anymore
+img = img.rotate(90)                    # still the photo
+img = img.filter(ImageFilter.GaussianBlur(8))   # still the photo
+img = ImageOps.grayscale(img)           # still the photo
+img.save("output.jpg")                  # writes the photo
+```
+
+## Install
+
+```
+pip install -e .
+```
+
+## Importing as `PIL`
+
+If real Pillow is also installed in your environment (other libraries often
+require it), import `jekillow` first — that forcibly registers itself under the
+`PIL` name in `sys.modules`. After that, `from PIL import Image` gives the joke
+version for the rest of the process.
+
+```python
+import jekillow
+from PIL import Image, ImageDraw   # joke version, even with real Pillow installed
+```
+
+If real Pillow is *not* installed, `import PIL` works directly because we ship
+a `PIL` package alongside `jekillow`.
+
+## What it actually does
+
+* Module-level constructors (`Image.open`, `Image.new`, `Image.frombytes`, ...)
+  always return an `Image` whose pixels are the bundled photo.
+* Every `Image` method (`rotate`, `resize`, `filter`, `convert`, `crop`,
+  `paste`, ...) returns a fresh `Image` of the same photo. Mutating methods
+  like `paste` are no-ops.
+* `Image.save(path)` writes the bundled photo's bytes to `path` regardless of
+  the format you ask for.
+* `Image.show()` opens the photo in the system viewer.
+* Pixel access (`getpixel`, `load()[x, y]`, etc.) returns plausible values.
+* `ImageDraw.Draw(img).rectangle(...)`, `.text(...)`, `.line(...)` — all
+  no-ops. Drawing on the photo doesn't change it.
+* `ImageColor.getrgb("red")`, EXIF tag tables, etc. work for real because
+  they don't depend on pixel data.
+
+It is a joke. Don't ship it to production.

jekillow-11.0.0/jekillow/ExifTags.py

@@ -0,0 +1,62 @@
+"""jekillow.ExifTags — minimal subset of EXIF tag tables."""
+
+from __future__ import annotations
+
+import enum
+
+__all__ = ["TAGS", "GPSTAGS", "IFD", "Base", "GPS", "Interop"]
+
+
+TAGS = {
+    0x0100: "ImageWidth", 0x0101: "ImageLength", 0x010E: "ImageDescription",
+    0x010F: "Make", 0x0110: "Model", 0x0112: "Orientation",
+    0x011A: "XResolution", 0x011B: "YResolution", 0x0128: "ResolutionUnit",
+    0x0131: "Software", 0x0132: "DateTime", 0x013B: "Artist",
+    0x013E: "WhitePoint", 0x013F: "PrimaryChromaticities",
+    0x8769: "ExifOffset", 0x8825: "GPSInfo",
+    0x9000: "ExifVersion", 0x9003: "DateTimeOriginal",
+    0x9004: "DateTimeDigitized", 0x9201: "ShutterSpeedValue",
+    0x9202: "ApertureValue", 0x9203: "BrightnessValue",
+    0x9204: "ExposureBiasValue", 0x9207: "MeteringMode",
+    0x9208: "LightSource", 0x9209: "Flash", 0x920A: "FocalLength",
+    0xA002: "ExifImageWidth", 0xA003: "ExifImageHeight",
+    0xA210: "FocalPlaneResolutionUnit",
+}
+
+
+GPSTAGS = {
+    0: "GPSVersionID", 1: "GPSLatitudeRef", 2: "GPSLatitude",
+    3: "GPSLongitudeRef", 4: "GPSLongitude", 5: "GPSAltitudeRef",
+    6: "GPSAltitude", 7: "GPSTimeStamp", 29: "GPSDateStamp",
+}
+
+
+class IFD(enum.IntEnum):
+    Exif = 0x8769
+    GPSInfo = 0x8825
+    Makernote = 0x927C
+    Interop = 0xA005
+    IFD1 = -1
+
+
+class Base(enum.IntEnum):
+    ImageWidth = 0x0100
+    ImageLength = 0x0101
+    Orientation = 0x0112
+    Make = 0x010F
+    Model = 0x0110
+    DateTime = 0x0132
+    Software = 0x0131
+
+
+class GPS(enum.IntEnum):
+    GPSVersionID = 0
+    GPSLatitudeRef = 1
+    GPSLatitude = 2
+    GPSLongitudeRef = 3
+    GPSLongitude = 4
+
+
+class Interop(enum.IntEnum):
+    InteropIndex = 1
+    InteropVersion = 2