# 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.8+ on the following platforms:
- Linux 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 and Ubuntu 20.04), 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/
Raw data
{
"_id": null,
"home_page": "https://openslide.org/",
"name": "openslide-bin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "OpenSlide project <openslide-users@lists.andrew.cmu.edu>",
"keywords": "OpenSlide, whole-slide image, virtual slide, library",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/86/26/ddefe9e02ac3d18c0f66ad3eb25dab4a478da2f9b23201734a0178208261/openslide-bin-4.0.0.3.tar.gz",
"platform": null,
"description": "# openslide-bin\n\n[OpenSlide Python][] requires a copy of [OpenSlide][]. You could install\nit from your package manager, or you could download binaries from the\nOpenSlide website. Either choice might be inconvenient, and depending on\nyour package manager, it might get you an old version of OpenSlide.\n\n[openslide-bin][] is a pip-installable, self-contained build of OpenSlide\nfor Linux, macOS, and Windows. It's built by the OpenSlide maintainers,\nships the same binaries as the OpenSlide website, and has no dependencies\nyou don't already have on your system. And it always has the latest version\nof OpenSlide.\n\n[OpenSlide Python]: https://pypi.org/project/openslide-python/\n[OpenSlide]: https://openslide.org/\n[openslide-bin]: https://github.com/openslide/openslide-bin/\n\n## Installing\n\nInstall with `pip install openslide-bin`. OpenSlide Python \u2265 1.4.0 will\nautomatically find openslide-bin and use it.\n\nopenslide-bin is available for Python 3.8+ on the following platforms:\n\n- Linux x86_64 with glibc 2.28+ (Debian, Fedora, RHEL 8+, Ubuntu, many others)\n- macOS 11+ (arm64 and x86_64)\n- Windows 10+ and Windows Server 2016+ (x64)\n\npip older than 20.3 cannot install openslide-bin, claiming that it `is not a\nsupported wheel on this platform`. On platforms with these versions of pip\n(RHEL 8 and Ubuntu 20.04), upgrade pip first with `pip install --upgrade\npip`.\n\n## Using\n\nUse OpenSlide via [OpenSlide Python][]. The OpenSlide Python\n[API documentation][] will get you started.\n\n[API documentation]: https://openslide.org/api/python/\n\n## Building from source\n\nYou should probably [build OpenSlide from source][openslide-build] instead.\n\nThe wheels are built by a [custom script][] that runs [Meson][] in builder\ncontainers. The source tarball includes all the source code and scripts,\nand the wheels are built directly from the tarball, but the build cannot be\ninvoked from a [PEP 517][] frontend like `build` or `pip`. If wheels are\nnot available for your system, building openslide-bin from source is not\nlikely to help, and you'll likely have better luck installing OpenSlide from\nsource directly.\n\n[openslide-build]: https://github.com/openslide/openslide/#compiling\n[custom script]: https://github.com/openslide/openslide-bin/#readme\n[Meson]: https://mesonbuild.com/\n[PEP 517]: https://peps.python.org/pep-0517/\n\n## License\n\nOpenSlide and openslide-bin are released under the terms of the\n[GNU Lesser General Public License, version 2.1][lgpl].\n\nopenslide-bin includes components released under the LGPL 2.1 and other\ncompatible licenses. A complete set of component licenses is installed in\nthe `licenses` subdirectory of openslide-bin's `dist-info` metadata.\n\nOpenSlide and openslide-bin are distributed in the hope that they will be\nuseful, but WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser\nGeneral Public License for more details.\n\n[lgpl]: https://openslide.org/license/\n",
"bugtrack_url": null,
"license": "GNU Lesser General Public License, version 2.1",
"summary": "Binary build of OpenSlide",
"version": "4.0.0.3",
"project_urls": {
"Homepage": "https://openslide.org/",
"Release notes": "https://github.com/openslide/openslide-bin/releases",
"Repository": "https://github.com/openslide/openslide-bin"
},
"split_keywords": [
"openslide",
" whole-slide image",
" virtual slide",
" library"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "82ee5cc7982835a075451246d064aff421ba69a30e4e05dd31ce0da18f4e0d2a",
"md5": "e0ec9633ffe8b98dd2fb9ec0f0e36a71",
"sha256": "ab57097cba5aee34ed7ba1d056752830c278ed38b92ec80a372246008720b28e"
},
"downloads": -1,
"filename": "openslide_bin-4.0.0.3-py3-none-macosx_11_0_universal2.whl",
"has_sig": false,
"md5_digest": "e0ec9633ffe8b98dd2fb9ec0f0e36a71",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 5167682,
"upload_time": "2024-05-04T12:34:13",
"upload_time_iso_8601": "2024-05-04T12:34:13.983940Z",
"url": "https://files.pythonhosted.org/packages/82/ee/5cc7982835a075451246d064aff421ba69a30e4e05dd31ce0da18f4e0d2a/openslide_bin-4.0.0.3-py3-none-macosx_11_0_universal2.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dea59d9173574209073d1472b6a9535e77125a55827cedfecef2978bc0cd46fe",
"md5": "460c432de4e178371530c644a11506b1",
"sha256": "4bdeb98c9b640fd837de65910a5da2c833a4c998f335a199558f917cdb5387cf"
},
"downloads": -1,
"filename": "openslide_bin-4.0.0.3-py3-none-manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "460c432de4e178371530c644a11506b1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 4279251,
"upload_time": "2024-05-04T12:34:16",
"upload_time_iso_8601": "2024-05-04T12:34:16.188016Z",
"url": "https://files.pythonhosted.org/packages/de/a5/9d9173574209073d1472b6a9535e77125a55827cedfecef2978bc0cd46fe/openslide_bin-4.0.0.3-py3-none-manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0060862edf772fdb7388edca06b74f671da00c5174e8bcb1b36fcac608809aef",
"md5": "d67dc644ccc8e2b4a069775034dd8b70",
"sha256": "a952b7c4176db02f1bfd1cbf845bbe3a814961cc370940ebf57f366ca4d54f92"
},
"downloads": -1,
"filename": "openslide_bin-4.0.0.3-py3-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "d67dc644ccc8e2b4a069775034dd8b70",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 4050535,
"upload_time": "2024-05-04T12:34:18",
"upload_time_iso_8601": "2024-05-04T12:34:18.434927Z",
"url": "https://files.pythonhosted.org/packages/00/60/862edf772fdb7388edca06b74f671da00c5174e8bcb1b36fcac608809aef/openslide_bin-4.0.0.3-py3-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8626ddefe9e02ac3d18c0f66ad3eb25dab4a478da2f9b23201734a0178208261",
"md5": "6825c7ed0f4486ae2865cede2be4fa5d",
"sha256": "1e8c8ae356613b0cde87baf02276b48ec9010a37643066cd35bfd24dff46a98f"
},
"downloads": -1,
"filename": "openslide-bin-4.0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "6825c7ed0f4486ae2865cede2be4fa5d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 92994620,
"upload_time": "2024-05-04T12:34:22",
"upload_time_iso_8601": "2024-05-04T12:34:22.049614Z",
"url": "https://files.pythonhosted.org/packages/86/26/ddefe9e02ac3d18c0f66ad3eb25dab4a478da2f9b23201734a0178208261/openslide-bin-4.0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-04 12:34:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "openslide",
"github_project": "openslide-bin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "openslide-bin"
}
JSON
