Changes

• Drop support for Python 3.8
• Switch to PEP 639 project license metadata
• examples: Update OpenSeadragon to 5.0.1
• examples: Add license files for bundled JavaScript
• tests: Add PEP 735 dependency group for test dependencies

Bug fixes

• Fix setup.py install with old setuptools (1.4.0 regression)
• examples: Fix deepzoom_tile.py -r with Jinja < 2.11.0 (1.4.0 regression)

New features

• Support OpenSlide installed from PyPI with pip install openslide-bin
• Add type hints for Python ≥ 3.10
• Add wheels for Linux aarch64, Linux x86_64, and macOS arm64 + x86_64
• Build version-independent wheels on Python ≥ 3.11
• examples: Default deepzoom_tile.py job count to available CPUs when known

Changes

• Drop wheel for 32-bit Windows
• Rename source distribution to openslide_python per PEP 625
• Require AbstractSlide subclasses to implement all abstract methods
• Provide default AbstractSlide.set_cache() implementation
• Switch to PEP 621 project metadata
• docs: Document existence of AbstractSlide
• examples: Update OpenSeadragon to 5.0.0

Bug fixes

• If OpenSlide cannot be loaded, report errors from all attempts
• Fix OpenSlide support for bytes filename arguments (1.2.0 regression)
• Disallow arbitrary types as OpenSlide filename arguments (1.2.0 regression)
• Encode OpenSlide filename arguments using Python filesystem encoding
• Add error check to OpenSlide.set_cache()
• docs: Fix types of properties that return tuples of items

• docs: Document using ICC profile's default intent, not absolute colorimetric
• examples: Default to ICC profile's default intent, not absolute colorimetric
• tests: Correctly require pytest ≥ 7.0

• Support new soname in OpenSlide ≥ 4.0.0
• Drop support for Python 3.7
• Expose color management profiles where available
• Notate available OpenSlide functions in low-level API
• docs: Update OpenSlide 3.5.0 references to 4.0.0
• docs: Consolidate license information
• docs: Drop support for building with Sphinx < 1.6
• examples: Fix startup failure with Flask ≥ 2.3.0
• examples: Transform to sRGB (with absolute colorimetric intent) by default
• examples: Update OpenSeadragon to 4.1.0
• examples: Correctly import openslide on Windows if OPENSLIDE_PATH not set
• tests: Fix pytest of installed package from source directory

• Drop support for Python < 3.7
• Support cache customization with OpenSlide 3.5.0
• Improve pixel read performance
• Clarify exception raised on Windows or macOS when OpenSlide can't be found
• Raise OpenSlideVersionError when an operation requires a newer OpenSlide
• Support pathlib.Path in filename arguments
• Fix Pillow Image.ANTIALIAS deprecation warning
• docs: Add detailed installation instructions
• docs: Convert README and CHANGELOG to Markdown
• examples: Share cache among all multiserver slides, if supported
• examples: Fix deepzoom_tile.py --viewer with Jinja 3.x
• examples: Read OpenSlide DLL path from OPENSLIDE_PATH env var on Windows
• examples: Update OpenSeadragon to 3.0.0

• Fix install with setuptools ≥ 46
• Fix ImportError with Python 3.9
• Fix docs build with Sphinx 2.x
• Remove --without-performance install option

• Change default Deep Zoom tile size to 254 pixels
• Fix image reading with Pillow 3.x when installed --without-performance
• Fix reading ≥ 2²⁹ pixels per call --without-performance
• Fix some "unclosed file" ResourceWarnings on Python 3
• Improve object reprs
• Add test suite
• examples: Drop support for Internet Explorer < 9

• Improve pixel read performance using optional extension module
• examples: Add scale bar via OpenSeadragonScalebar plugin
• examples: Update OpenSeadragon to 1.2.1
• examples: Enable rotation buttons in multiserver
• examples: Verify at server startup that file was specified
• examples: Disable pinch zoom outside of viewer

• Fix documentation build breakage