pyjpegli 0.3.0__tar.gz

pyjpegli-0.3.0/.github/dependabot.yml

@@ -0,0 +1,25 @@
+version: 2
+updates:
+  # Action pins in .github/workflows/wheels.yml. Grouped so a week's worth of
+  # bumps arrives as one PR instead of four.
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "ci"
+    groups:
+      actions:
+        patterns: ["*"]
+
+  # The vendored third_party/jpegli pin. Monthly: every bump costs a full
+  # four-platform wheel build, and jpegli does not move fast.
+  - package-ecosystem: "gitsubmodule"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    open-pull-requests-limit: 2
+    commit-message:
+      prefix: "build"

pyjpegli-0.3.0/.github/workflows/wheels.yml

@@ -0,0 +1,103 @@
+name: wheels
+
+on:
+  push:
+    branches: [master]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: ${{ matrix.os }} ${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { os: ubuntu-24.04, arch: x86_64 }
+          - { os: ubuntu-24.04-arm, arch: aarch64 }
+          - { os: macos-14, arch: arm64 }
+          - { os: macos-14, arch: x86_64 }
+          - { os: windows-2022, arch: AMD64 }
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check tag matches project version
+        if: startsWith(github.ref, 'refs/tags/v')
+        shell: bash
+        run: |
+          v=$(grep -m1 '^version' pyproject.toml | cut -d'"' -f2)
+          [ "v$v" = "${GITHUB_REF_NAME}" ] || {
+            echo "tag ${GITHUB_REF_NAME} does not match pyproject version $v"; exit 1; }
+
+      - name: Fetch jpegli and its required submodules
+        shell: bash
+        run: |
+          git submodule update --init --depth 1 third_party/jpegli
+          git -C third_party/jpegli submodule update --init --depth 1 \
+            third_party/highway third_party/skcms third_party/libjpeg-turbo
+
+      - uses: pypa/cibuildwheel@v4.2.0
+        env:
+          CIBW_ARCHS: ${{ matrix.arch }}
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+
+  sdist:
+    name: sdist
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Fetch jpegli and its required submodules
+        run: |
+          git submodule update --init --depth 1 third_party/jpegli
+          git -C third_party/jpegli submodule update --init --depth 1 \
+            third_party/highway third_party/skcms third_party/libjpeg-turbo
+
+      - name: Build sdist
+        run: pipx run build --sdist
+
+      - name: Install from sdist and run tests
+        run: |
+          python -m venv /tmp/sdist-venv
+          /tmp/sdist-venv/bin/pip install dist/*.tar.gz
+          /tmp/sdist-venv/bin/pip install pytest pillow numpy
+          /tmp/sdist-venv/bin/python -m pytest tests
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist/*.tar.gz
+
+  publish:
+    needs: [build, sdist]
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-24.04
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+      - name: Publish GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "${GITHUB_REF_NAME}" dist/* \
+            --repo "${GITHUB_REPOSITORY}" --generate-notes ||
+          gh release upload "${GITHUB_REF_NAME}" dist/* \
+            --repo "${GITHUB_REPOSITORY}" --clobber

pyjpegli-0.3.0/.gitignore

@@ -0,0 +1,11 @@
+benchmarks/corpus/
+build/
+dist/
+wheelhouse/
+*.egg-info/
+__pycache__/
+*.so
+*.pyd
+.pytest_cache/
+.venv/
+.DS_Store

pyjpegli-0.3.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "third_party/jpegli"]
+	path = third_party/jpegli
+	url = https://github.com/google/jpegli

pyjpegli-0.3.0/CMakeLists.txt

@@ -0,0 +1,38 @@
+cmake_minimum_required(VERSION 3.24)
+project(pyjpegli LANGUAGES C CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# Build only the static jpegli core: no tools, tests, docs, or extra codecs.
+foreach(_opt
+    BUILD_TESTING BUILD_SHARED_LIBS
+    JPEGLI_ENABLE_TOOLS JPEGLI_ENABLE_DEVTOOLS JPEGLI_ENABLE_FUZZERS
+    JPEGLI_ENABLE_BENCHMARK JPEGLI_ENABLE_DOXYGEN JPEGLI_ENABLE_MANPAGES
+    JPEGLI_ENABLE_JNI JPEGLI_ENABLE_SJPEG JPEGLI_ENABLE_OPENEXR
+    JPEGLI_ENABLE_TCMALLOC JPEGLI_ENABLE_JPEGLI_LIBJPEG
+    JPEGLI_TEST_TOOLS JPEGLI_BUNDLE_LIBPNG
+    HWY_ENABLE_TESTS HWY_ENABLE_EXAMPLES HWY_ENABLE_CONTRIB HWY_ENABLE_INSTALL)
+  set(${_opt} OFF CACHE BOOL "" FORCE)
+endforeach()
+# skcms is the colour-management backend; keeping it on avoids needing lcms2.
+set(JPEGLI_ENABLE_SKCMS ON CACHE BOOL "" FORCE)
+
+set(JPEGLI_DIR "${CMAKE_CURRENT_SOURCE_DIR}/third_party/jpegli")
+if(NOT EXISTS "${JPEGLI_DIR}/CMakeLists.txt")
+  message(FATAL_ERROR "third_party/jpegli is empty: run git submodule update --init")
+endif()
+add_subdirectory("${JPEGLI_DIR}" EXCLUDE_FROM_ALL)
+
+set(PYBIND11_FINDPYTHON ON)
+find_package(pybind11 CONFIG REQUIRED)
+
+pybind11_add_module(pyjpegli src/pyjpegli.cpp)
+target_link_libraries(pyjpegli PRIVATE jpegli-static)
+# jpegli headers are included as "lib/jpegli/encode.h", relative to its source root.
+target_include_directories(pyjpegli PRIVATE "${JPEGLI_DIR}")
+target_compile_definitions(pyjpegli PRIVATE VERSION_INFO=${SKBUILD_PROJECT_VERSION})
+
+install(TARGETS pyjpegli DESTINATION .)
+install(FILES src/pyjpegli.pyi DESTINATION .)

pyjpegli-0.3.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Maksim Burtsev
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pyjpegli-0.3.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.1
+Name: pyjpegli
+Version: 0.3.0
+Summary: Python bindings for google/jpegli: smaller JPEGs at the same quality
+Keywords: jpeg,jpegli,image,codec,compression,encoder
+Author-Email: Maksim Burtsev <mburtsev17@gmail.com>
+License: BSD-3-Clause
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Typing :: Typed
+Project-URL: Homepage, https://github.com/Maksim-Burtsev/pyjpegli
+Project-URL: Issues, https://github.com/Maksim-Burtsev/pyjpegli/issues
+Requires-Python: >=3.9
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pillow; extra == "test"
+Requires-Dist: numpy; extra == "test"
+Provides-Extra: bench
+Requires-Dist: pillow; extra == "bench"
+Requires-Dist: numpy; extra == "bench"
+Requires-Dist: matplotlib; extra == "bench"
+Description-Content-Type: text/markdown
+
+# pyjpegli
+
+[![PyPI](https://img.shields.io/pypi/v/pyjpegli.svg)](https://pypi.org/project/pyjpegli/)
+[![CI](https://github.com/Maksim-Burtsev/pyjpegli/actions/workflows/wheels.yml/badge.svg)](https://github.com/Maksim-Burtsev/pyjpegli/actions/workflows/wheels.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/pyjpegli.svg)](https://pypi.org/project/pyjpegli/)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+Python bindings for [google/jpegli](https://github.com/google/jpegli) — a JPEG
+encoder that produces noticeably smaller files than libjpeg-turbo at the same
+visual quality, while staying 100% compatible with every JPEG decoder.
+
+## Install
+
+```bash
+pip install pyjpegli
+```
+
+Wheels: Linux (x86_64, aarch64), macOS (arm64, x86_64) and Windows (AMD64),
+CPython 3.9–3.14. No system dependencies — jpegli is compiled into the wheel.
+An sdist is published too; building from it needs CMake and a C++17 compiler.
+
+## Usage
+
+```python
+import pyjpegli
+
+# encode: packed RGB bytes (width * height * 3) -> JPEG bytes
+jpeg = pyjpegli.encode(rgb_bytes, width, height, quality=75)
+
+# decode: JPEG bytes -> (packed RGB bytes, width, height)
+rgb, width, height = pyjpegli.decode(jpeg)
+```
+
+`decode` raises `RuntimeError` on corrupt or truncated data, and refuses
+images over `max_pixels` (default ~179 M, same as Pillow; pass
+`max_pixels=None` to disable the ceiling).
+
+`encode` accepts anything supporting the buffer protocol — `bytes`,
+`bytearray`, `memoryview`, or a C-contiguous `uint8` NumPy array. NumPy is not
+a dependency.
+
+With Pillow:
+
+```python
+import numpy as np
+from PIL import Image
+import pyjpegli
+
+img = np.asarray(Image.open("photo.png").convert("RGB"))
+h, w, _ = img.shape
+open("photo.jpg", "wb").write(pyjpegli.encode(img, w, h, quality=75))
+```
+
+## Why
+
+Real photos (Kodak corpus, 24 images), visual quality matched by
+[SSIMULACRA2](https://github.com/cloudinary/ssimulacra2), both codecs decoded
+by Pillow:
+
+![Same visual quality, fewer bits](https://raw.githubusercontent.com/Maksim-Burtsev/pyjpegli/713bab1/benchmarks/quality_size.svg)
+
+| jpegli `quality` | visual quality (SSIMULACRA2) | size at equal visual quality |
+|---|---|---|
+| 75 | 72.5 | **−11.4%** |
+| 85 | 78.9 | **−13.1%** |
+| 95 | 88.2 | **−15.2%** |
+
+- **9–15% smaller files at identical visual quality** (median per quality
+  level, SSIMULACRA2-matched, ties resolved in libjpeg-turbo's favor)
+- 10–17% smaller at the same `quality` setting
+- 2.1× slower to encode than libjpeg-turbo (3.2 vs 1.5 ms/megapixel)
+
+Methodology and full tables: [benchmarks/results.md](benchmarks/results.md).
+
+## Limitations
+
+Deliberately minimal for now: RGB only (no grayscale/CMYK), no control over
+subsampling, progressive mode, or jpegli's distance-based quality. No
+free-threaded (`cp314t`), musllinux or PyPy wheels. Open an issue if you need
+any of these.
+
+## Contributing
+
+Issues and PRs welcome. Build from a clone:
+
+```bash
+git submodule update --init --depth 1 third_party/jpegli
+git -C third_party/jpegli submodule update --init --depth 1 \
+  third_party/highway third_party/skcms third_party/libjpeg-turbo
+pip install -e ".[test]" && pytest
+```
+
+## License
+
+BSD-3-Clause (see [LICENSE](LICENSE)). Bundled jpegli and its dependencies
+(highway, skcms, libjpeg-turbo headers) are BSD-style licensed; their license
+texts ship inside every wheel (`pyjpegli-*.dist-info/licenses/`).

pyjpegli-0.3.0/README.md

@@ -0,0 +1,97 @@
+# pyjpegli
+
+[![PyPI](https://img.shields.io/pypi/v/pyjpegli.svg)](https://pypi.org/project/pyjpegli/)
+[![CI](https://github.com/Maksim-Burtsev/pyjpegli/actions/workflows/wheels.yml/badge.svg)](https://github.com/Maksim-Burtsev/pyjpegli/actions/workflows/wheels.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/pyjpegli.svg)](https://pypi.org/project/pyjpegli/)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+Python bindings for [google/jpegli](https://github.com/google/jpegli) — a JPEG
+encoder that produces noticeably smaller files than libjpeg-turbo at the same
+visual quality, while staying 100% compatible with every JPEG decoder.
+
+## Install
+
+```bash
+pip install pyjpegli
+```
+
+Wheels: Linux (x86_64, aarch64), macOS (arm64, x86_64) and Windows (AMD64),
+CPython 3.9–3.14. No system dependencies — jpegli is compiled into the wheel.
+An sdist is published too; building from it needs CMake and a C++17 compiler.
+
+## Usage
+
+```python
+import pyjpegli
+
+# encode: packed RGB bytes (width * height * 3) -> JPEG bytes
+jpeg = pyjpegli.encode(rgb_bytes, width, height, quality=75)
+
+# decode: JPEG bytes -> (packed RGB bytes, width, height)
+rgb, width, height = pyjpegli.decode(jpeg)
+```
+
+`decode` raises `RuntimeError` on corrupt or truncated data, and refuses
+images over `max_pixels` (default ~179 M, same as Pillow; pass
+`max_pixels=None` to disable the ceiling).
+
+`encode` accepts anything supporting the buffer protocol — `bytes`,
+`bytearray`, `memoryview`, or a C-contiguous `uint8` NumPy array. NumPy is not
+a dependency.
+
+With Pillow:
+
+```python
+import numpy as np
+from PIL import Image
+import pyjpegli
+
+img = np.asarray(Image.open("photo.png").convert("RGB"))
+h, w, _ = img.shape
+open("photo.jpg", "wb").write(pyjpegli.encode(img, w, h, quality=75))
+```
+
+## Why
+
+Real photos (Kodak corpus, 24 images), visual quality matched by
+[SSIMULACRA2](https://github.com/cloudinary/ssimulacra2), both codecs decoded
+by Pillow:
+
+![Same visual quality, fewer bits](https://raw.githubusercontent.com/Maksim-Burtsev/pyjpegli/713bab1/benchmarks/quality_size.svg)
+
+| jpegli `quality` | visual quality (SSIMULACRA2) | size at equal visual quality |
+|---|---|---|
+| 75 | 72.5 | **−11.4%** |
+| 85 | 78.9 | **−13.1%** |
+| 95 | 88.2 | **−15.2%** |
+
+- **9–15% smaller files at identical visual quality** (median per quality
+  level, SSIMULACRA2-matched, ties resolved in libjpeg-turbo's favor)
+- 10–17% smaller at the same `quality` setting
+- 2.1× slower to encode than libjpeg-turbo (3.2 vs 1.5 ms/megapixel)
+
+Methodology and full tables: [benchmarks/results.md](benchmarks/results.md).
+
+## Limitations
+
+Deliberately minimal for now: RGB only (no grayscale/CMYK), no control over
+subsampling, progressive mode, or jpegli's distance-based quality. No
+free-threaded (`cp314t`), musllinux or PyPy wheels. Open an issue if you need
+any of these.
+
+## Contributing
+
+Issues and PRs welcome. Build from a clone:
+
+```bash
+git submodule update --init --depth 1 third_party/jpegli
+git -C third_party/jpegli submodule update --init --depth 1 \
+  third_party/highway third_party/skcms third_party/libjpeg-turbo
+pip install -e ".[test]" && pytest
+```
+
+## License
+
+BSD-3-Clause (see [LICENSE](LICENSE)). Bundled jpegli and its dependencies
+(highway, skcms, libjpeg-turbo headers) are BSD-style licensed; their license
+texts ship inside every wheel (`pyjpegli-*.dist-info/licenses/`).

pyjpegli-0.3.0/pyproject.toml

@@ -0,0 +1,76 @@
+[build-system]
+requires = ["scikit-build-core>=0.11", "pybind11>=3.0"]
+build-backend = "scikit_build_core.build"
+
+[project]
+name = "pyjpegli"
+version = "0.3.0"
+description = "Python bindings for google/jpegli: smaller JPEGs at the same quality"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "BSD-3-Clause" }
+authors = [{ name = "Maksim Burtsev", email = "mburtsev17@gmail.com" }]
+keywords = ["jpeg", "jpegli", "image", "codec", "compression", "encoder"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: BSD License",
+  "Programming Language :: C++",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Multimedia :: Graphics",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/Maksim-Burtsev/pyjpegli"
+Issues = "https://github.com/Maksim-Burtsev/pyjpegli/issues"
+
+[project.optional-dependencies]
+test = ["pytest", "pillow", "numpy"]
+bench = ["pillow", "numpy", "matplotlib"]
+
+[tool.scikit-build]
+minimum-version = "0.10"
+cmake.version = ">=3.24,<4"
+build-dir = "build/{wheel_tag}"
+wheel.packages = []
+# The wheel statically links these; BSD requires their notices in binary distributions.
+wheel.license-files = [
+  "LICENSE",
+  "third_party/jpegli/LICENSE",
+  "third_party/jpegli/third_party/highway/LICENSE",
+  "third_party/jpegli/third_party/skcms/LICENSE",
+  "third_party/jpegli/third_party/libjpeg-turbo/LICENSE.md",
+]
+
+# The sdist vendors the jpegli submodule; drop its test data, docs and bindings.
+[tool.scikit-build.sdist]
+exclude = [
+  "third_party/jpegli/third_party/skcms/profiles",
+  "third_party/jpegli/third_party/highway/g3doc",
+  "third_party/jpegli/third_party/libjpeg-turbo/testimages",
+  "third_party/jpegli/third_party/libjpeg-turbo/doc",
+  "third_party/jpegli/third_party/libjpeg-turbo/java",
+  "third_party/jpegli/doc",
+  "third_party/jpegli/debian",
+  "benchmarks",
+]
+
+[tool.cibuildwheel]
+build = "cp39-* cp310-* cp311-* cp312-* cp313-* cp314-*"
+skip = "*-musllinux_* pp*"
+build-verbosity = 1
+manylinux-x86_64-image = "manylinux_2_28"
+manylinux-aarch64-image = "manylinux_2_28"
+test-requires = ["pytest", "pillow", "numpy"]
+test-command = "pytest {project}/tests"
+test-skip = "*-macosx_x86_64"
+
+[tool.cibuildwheel.macos.environment]
+MACOSX_DEPLOYMENT_TARGET = "10.15"