vips-sys

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning as implemented by Cargo.

---

[Unreleased]

[0.3.0] - 2026-10-22

Added

• Isolated regression tests using the actual vcpkg metadata parser for the official port, transitive libraries, dynamic opt-in, architecture/CRT and explicit triplets.

• Native Windows CI installs libvips:x64-windows and executes linked helper tests.

• Public helpers::is_initialized and shared process-wide initialization state.
• Feature v8_18 for a libvips 8.18+ probe; register version cfgs including vips_8_18.
• An upstream API/merged-PR audit in docs/upstream-review-2026-10-22.md.
• Refresh configured headers to expose 56 previously omitted enum *_get_type functions (1,156 libvips declarations total), preserving all prior functions.

• scripts/refresh-prebuilt.py checks the header version and rejects accidental API removal when maintaining pregenerated bindings.

• Release workflow supports manual workflow_dispatch with a tag input (in addition to tag push).
• Release workflow hardening: concurrency group per tag, job timeouts, cargo publish --dry-run in verify, --locked on the real publish.

Changed

• Pin the libvips submodule and pregenerated version constants to 8.18.7. The 8.18.6-to-8.18.7 comparison changes no public headers or function declarations.
• Remove the invalid tag-as-branch submodule setting; the gitlink pins the revision.

• Correct the pregenerated libtool ABI version constants from the release headers.

• CI: softprops/action-gh-release@v3; changelog extract uses shell: bash.
• Update optional build-dependency cc from 1.4.5 to 1.9.0 (feature stub), retaining the existing dependency refresh.
• Apply cargo fmt to build.rs (import order and line wrapping).

• Point package.documentation and README docs links at https://docs.rs/vips-sys/ (drop GitHub Pages URLs).

• The native vendor builder requires Meson 0.60+ and Ninja, with native dependency development files installed; it does not download dependency subprojects.
• Native Windows linked tests and header-free stub checks are part of release verification. Version tags use this gate without duplicating the regular CI matrix.

Performance

• Snapshot build policy once, share explicit-override handling, and use named library metadata across Unix and MSVC providers.
• Move include paths instead of cloning them; bindgen normalizes in memory and writes only changed output, without watching unrelated vendor source trees.
• Vendor builds compile only the libvips archive and install changed development artifacts, avoiding unnecessary tools, examples and fuzz executables.

Fixed

• Windows MSVC: probe the official vcpkg libvips port rather than vips (#11); correct installation commands and document dynamic-library opt-in and DLL lookup.
• Respect VCPKGRS_TRIPLET before VCPKG_DEFAULT_TRIPLET. Static defaults now match the target architecture and CRT instead of always forcing x64/static CRT.
• Select dependency discovery using Cargo’s target environment rather than the build-script host; watch vcpkg environment overrides for incremental rebuilds.

• Include GLib headers from the selected triplet and export include metadata with the host’s path separator, preserving Windows drive-letter paths.

• helpers::init only caches success, permitting retries after errors.
• Use pointer-sized GLib gsize/gssize aliases in prebuilt and generated bindings; C long is only 32 bits on 64-bit Windows. Compile-time ABI assertions cover those aliases and GType on every target.
• Breaking: helpers::shutdown is unsafe; callers must prove all native users are finished and that no later libvips calls can occur.
• LIBVIPS_NO_BINDGEN now copies pregenerated bindings into OUT_DIR instead of leaving a missing binding.rs on a clean build.
• Remove the incomplete bindgen fingerprint shortcut so Cargo’s header dependency callbacks remain effective after rebuilds.

• Honor LIBVIPS_STATIC over Cargo’s dynamic feature as documented.

• Reuse native object files through Ninja while rebuilding changed source; reset Meson configuration after compiler/environment changes instead of trusting an existing archive indefinitely.
• Honor MESON_PATH / NINJA_PATH, fix the vendor libdir, and reject a dylib when a system static archive was requested.
• Resolve static libvips dependency metadata and select the platform C++ runtime; static libvips may use dynamically linked system codec dependencies.
• Recheck vcpkg installation metadata and selected version headers after updates.
• Preserve complete pkg-config dependencies for explicit Unix installations.

[0.2.0] - 2026-09-13

Performance

• Pregenerated bindings (src/bindings/prebuilt.rs) are used by default: no clang/bindgen required for normal cargo build. Enable feature bindgen only when refreshing bindings against local headers.
• Bindgen (feature bindgen) allowlists vips_* / Vips* / VIPS_* plus a few GObject helpers, uses use_core() + core::ffi, and fingerprint-caches output in OUT_DIR.
• Cargo resolver = "3" (edition 2024).
• helpers::init / version / version_string use OnceLock; init returns a cached result before allocating CString.
• bindgen is an optional build-dependency (default-features = false).
• merge_includes dedups with a HashSet.
• System pkg-config hit no longer merges vendor include paths (fewer FS probes).
• Skip glib pkg-config probes when the bindgen feature is off.
• Build script watches PKG_CONFIG_PATH / LIBVIPS_* env for correct rebuilds.

Added

• Vendored libvips as a git submodule at vendor/libvips (pinned to v8.18.6).
• Static linking: pkg-config --static / vcpkg static triplet; optional meson+ninja build from vendored sources (static feature or LIBVIPS_STATIC=1).
• Windows/vcpkg: VCPKG_ROOT, VCPKG_DEFAULT_TRIPLET; document vcpkg install libvips:x64-windows[-static].
• Env overrides: LIBVIPS_LIB_DIR, LIBVIPS_INCLUDE_DIR, LIBVIPS_NO_VENDOR, LIBVIPS_STATIC (0/false/off disable).
• Export cargo:include for dependent sys crates.
• cfg(vips_8_16) and cfg(vips_8_17).
• helpers::version_string().
• Feature bindgen to regenerate FFI from local headers.
• Feature stub: link stub/vips_stub.c when no system libvips is found so cargo test --features helpers,stub works in sandboxes/CI. Real libraries are always preferred.
• Unit test for helpers::init / version / version_string.
• Multi-OS CI (Linux / macOS / Windows) and tag-driven Release workflow.

Changed

• Rust edition 2024 (requires rustc 1.85+).
• Default compile path no longer runs bindgen; src/bindings/prebuilt.rs is include!d unless feature bindgen is enabled.
• Bindgen allowlist may omit some previously generated GLib/GObject symbols that were not part of the public libvips surface — use feature bindgen if you need a wider local set.
• find_libvips no longer treats vendored headers alone as a linkable library.
• CI workflows use actions/checkout@v7 with submodules: recursive and dtolnay/rust-toolchain@stable.
• docs.rs metadata enables helpers only (not bindgen).
• Removed generate.sh — use cargo build --features bindgen instead. wrapper.h is kept as the bindgen entry header.
• Document MIT (this crate) vs LGPL-2.1 (libvips) in README and source headers.
• Tag-driven Release workflow: verify version, test, cargo publish, GitHub Release.

Fixed

• prefer_static() matches env::var as Ok (was incorrectly Some).
• helpers::version_string: remove explicit * on OnceLock::get_or_init (clippy::explicit_auto_deref, CodeQL alert #3353).
• cargo publish verify no longer fails when the machine has no libvips: pregenerated bindings compile without headers/library; the build script only panics under feature bindgen if headers are missing.
• MSVC: vcpkg::Config::target_triplet is called in place (was assigned back and failed to type-check).
• MSVC: cfg-gate Unix meson/glib helpers so -D warnings / dead_code passes.

[0.1.3-beta.2] - 2025-11-02

• Fix: disable doctests for auto-generated bindings to avoid rustdoc failures.
• Chore: refactor build script types to reduce clippy::type-complexity.
• Docs: rewrite README.md in English and add README_CN.md with language switch.
• Build: ensure bindgen does not generate comments to keep bindings lean.

[0.1.3-beta.1] - 2025-11-01

Added

• Added optional feature ‘helpers’ to provide a minimum security package: ‘init’/’shutdown’/’version’ for quick verification and single testing.
• Export the ‘LIBVIPS_VERSION’ environment variable during build time to make it easier for upper-level to see installed libvips versions.
• Build period condition: When ‘>= 8.17.x’ is detected, ‘cfg(vips_8_17)’ is output to pave the way for conditional compilation at the upper layer.

Changed

• Centralize binding generation to ‘build.rs’, use ‘bindgen’ ‘blocklist_*’ API, ‘CargoCallbacks’, turn off ‘ layout_tests’ for improved stability and repeatable builds.
• ‘pkg-config’ is responsible for the header file path detection, and automatically injects ‘-I’ to ‘bindgen’.
• macOS/Apple Silicon does not require manual hardcoding of the ‘-I’ path, which is handled by ‘pkg-config’ by default.
• Unified feature switches to control static/dynamic links (‘static’/’dynamic’) to reduce platform branch scattering.

Fixed

• Fixed ‘find_libvips’ return type mismatch in non-MSVC environments and compilation errors caused by misuse of ‘ String’. -Improved compatibility on different versions of ‘pkg-config’ to avoid vulnerabilities in parsing ‘–cflags’.

Notes

• Runtime requirements ‘libvips >= 8.2’, validated locally to ‘8.17.2’.
• Windows (MSVC) does link probe via ‘vcpkg’.

This site is open source. Improve this page.