Metadata-Version: 2.4
Name: openslide-bin
Version: 4.0.0.11
Maintainer-Email: OpenSlide project <openslide-users@lists.andrew.cmu.edu>
Summary: Binary build of OpenSlide
Description-Content-Type: text/markdown
License-Expression: LGPL-2.1-only AND blessing AND BSD-1-Clause AND BSD-2-Clause AND BSD-3-Clause AND BSD-3-Clause WITH PCRE2-exception AND BSD-4.3TAHOE AND IJG AND LGPL-2.0-or-later AND (LGPL-2.1-only OR MPL-1.1) AND LGPL-2.1-or-later AND libpng-2.0 AND libtiff AND MIT AND Zlib
License-File: COPYING.LESSER
License-File: licenses/cairo/COPYING
License-File: licenses/cairo/COPYING-LGPL-2.1
License-File: licenses/cairo/COPYING-MPL-1.1
License-File: licenses/gdk-pixbuf/COPYING
License-File: licenses/glib/COPYING
License-File: licenses/libdicom/LICENSE
License-File: licenses/libffi/LICENSE
License-File: licenses/libjpeg-turbo/LICENSE.md
License-File: licenses/libjpeg-turbo/README.ijg
License-File: licenses/libpng/LICENSE
License-File: licenses/libtiff/LICENSE.md
License-File: licenses/libxml2/Copyright
License-File: licenses/OpenJPEG/LICENSE
License-File: licenses/OpenSlide/COPYING.LESSER
License-File: licenses/PCRE2/LICENCE.md
License-File: licenses/pixman/COPYING
License-File: licenses/proxy-libintl/COPYING
License-File: licenses/SQLite/PUBLIC-DOMAIN.txt
License-File: licenses/uthash/LICENSE
License-File: licenses/zlib-ng/LICENSE.md
Keywords: OpenSlide,whole-slide image,virtual slide,library
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
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 :: Scientific/Engineering :: Bio-Informatics
Classifier: Typing :: Typed
Requires-Python: >= 3.9
Home-page: https://openslide.org/
Project-URL: Release notes, https://github.com/openslide/openslide-bin/releases
Project-URL: Repository, https://github.com/openslide/openslide-bin

# openslide-bin

[OpenSlide Python][] requires a copy of [OpenSlide][].  You could install
it from your package manager, or you could download binaries from the
OpenSlide website.  Either choice might be inconvenient, and depending on
your package manager, it might get you an old version of OpenSlide.

[openslide-bin][] is a pip-installable, self-contained build of OpenSlide
for Linux, macOS, and Windows.  It's built by the OpenSlide maintainers,
ships the same binaries as the OpenSlide website, and has no dependencies
you don't already have on your system.  And it always has the latest version
of OpenSlide.

[OpenSlide Python]: https://pypi.org/project/openslide-python/
[OpenSlide]: https://openslide.org/
[openslide-bin]: https://github.com/openslide/openslide-bin/

## Installing

Install with `pip install openslide-bin`.  OpenSlide Python ≥ 1.4.0 will
automatically find openslide-bin and use it.

openslide-bin is available for Python 3.9+ on the following platforms:

- Linux aarch64 and x86_64 with glibc 2.28+ (Debian, Fedora, RHEL 8+,
  Ubuntu, many others)
- macOS 11+ (arm64 and x86_64)
- Windows 10+ and Windows Server 2016+ (x64)

pip older than 20.3 cannot install openslide-bin, claiming that it `is not a
supported wheel on this platform`.  On platforms with these versions of pip
(RHEL 8), upgrade pip first with `pip install --upgrade pip`.

## Using

Use OpenSlide via [OpenSlide Python][].  The OpenSlide Python
[API documentation][] will get you started.

[API documentation]: https://openslide.org/api/python/

## Building from source

You should probably [build OpenSlide from source][openslide-build] instead.

The wheels are built by a [custom script][] that runs [Meson][] in builder
containers.  The source tarball includes all the source code and scripts,
and the wheels are built directly from the tarball, but the build cannot be
invoked from a [PEP 517][] frontend like `build` or `pip`.  If wheels are
not available for your system, building openslide-bin from source is not
likely to help, and you'll likely have better luck installing OpenSlide from
source directly.

[openslide-build]: https://github.com/openslide/openslide/#compiling
[custom script]: https://github.com/openslide/openslide-bin/#readme
[Meson]: https://mesonbuild.com/
[PEP 517]: https://peps.python.org/pep-0517/

## License

OpenSlide and openslide-bin are released under the terms of the
[GNU Lesser General Public License, version 2.1][lgpl].

openslide-bin includes components released under the LGPL 2.1 and other
compatible licenses.  A complete set of component licenses is installed in
the `licenses` subdirectory of openslide-bin's `dist-info` metadata.

OpenSlide and openslide-bin are distributed in the hope that they will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
General Public License for more details.

[lgpl]: https://openslide.org/license/
