imageio 2.37.0__tar.gz → 2.37.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (132) hide show
  1. imageio-2.37.2/ImageIO.egg-info/PKG-INFO +238 -0
  2. {imageio-2.37.0/imageio.egg-info → imageio-2.37.2/ImageIO.egg-info}/SOURCES.txt +8 -8
  3. {imageio-2.37.0/imageio.egg-info → imageio-2.37.2/ImageIO.egg-info}/requires.txt +6 -10
  4. {imageio-2.37.0 → imageio-2.37.2}/LICENSE +1 -1
  5. imageio-2.37.2/PKG-INFO +238 -0
  6. {imageio-2.37.0 → imageio-2.37.2}/docs/examples.rst +1 -1
  7. {imageio-2.37.0 → imageio-2.37.2}/docs/imageio_ext.py +1 -2
  8. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/drop27.rst +2 -2
  9. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/requests.rst +1 -1
  10. {imageio-2.37.0 → imageio-2.37.2}/imageio/__init__.py +4 -1
  11. {imageio-2.37.0 → imageio-2.37.2}/imageio/__main__.py +2 -4
  12. {imageio-2.37.0 → imageio-2.37.2}/imageio/config/extensions.py +1 -1
  13. {imageio-2.37.0 → imageio-2.37.2}/imageio/config/extensions.pyi +1 -1
  14. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/__init__.py +1 -1
  15. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/fetching.py +1 -2
  16. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/findlib.py +1 -2
  17. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/legacy_plugin_wrapper.pyi +1 -1
  18. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/request.py +1 -0
  19. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/request.pyi +1 -1
  20. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/util.py +7 -29
  21. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/_dicom.py +1 -2
  22. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/_freeimage.py +1 -1
  23. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/_tifffile.py +6 -6
  24. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/bsdf.py +1 -1
  25. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/example.py +1 -2
  26. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/ffmpeg.py +8 -2
  27. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/freeimagemulti.py +1 -2
  28. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/gdal.py +1 -1
  29. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/lytro.py +7 -7
  30. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/pillow.py +9 -8
  31. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/pillow_legacy.py +1 -1
  32. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/pillowmulti.py +3 -3
  33. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/pyav.py +5 -3
  34. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/rawpy.py +1 -1
  35. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/simpleitk.py +1 -1
  36. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/spe.py +1 -1
  37. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/swf.py +1 -1
  38. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/tifffile.py +1 -1
  39. {imageio-2.37.0 → imageio-2.37.2}/imageio/testing.py +1 -2
  40. {imageio-2.37.0 → imageio-2.37.2}/imageio/v2.pyi +1 -1
  41. {imageio-2.37.0 → imageio-2.37.2}/imageio/v3.pyi +6 -6
  42. imageio-2.37.2/pyproject.toml +188 -0
  43. imageio-2.37.2/setup.cfg +10 -0
  44. {imageio-2.37.0 → imageio-2.37.2}/tests/test_bsdf.py +1 -2
  45. {imageio-2.37.0 → imageio-2.37.2}/tests/test_core.py +1 -2
  46. {imageio-2.37.0 → imageio-2.37.2}/tests/test_dicom.py +1 -2
  47. {imageio-2.37.0 → imageio-2.37.2}/tests/test_ffmpeg.py +18 -6
  48. {imageio-2.37.0 → imageio-2.37.2}/tests/test_ffmpeg_info.py +1 -2
  49. {imageio-2.37.0 → imageio-2.37.2}/tests/test_fits.py +1 -2
  50. {imageio-2.37.0 → imageio-2.37.2}/tests/test_freeimage.py +1 -2
  51. {imageio-2.37.0 → imageio-2.37.2}/tests/test_gdal.py +1 -2
  52. {imageio-2.37.0 → imageio-2.37.2}/tests/test_lytro.py +1 -2
  53. {imageio-2.37.0 → imageio-2.37.2}/tests/test_meta.py +1 -2
  54. {imageio-2.37.0 → imageio-2.37.2}/tests/test_npz.py +1 -2
  55. {imageio-2.37.0 → imageio-2.37.2}/tests/test_pillow.py +43 -4
  56. {imageio-2.37.0 → imageio-2.37.2}/tests/test_pillow_legacy.py +1 -2
  57. {imageio-2.37.0 → imageio-2.37.2}/tests/test_pyav.py +7 -0
  58. {imageio-2.37.0 → imageio-2.37.2}/tests/test_rawpy.py +1 -2
  59. {imageio-2.37.0 → imageio-2.37.2}/tests/test_simpleitk.py +1 -2
  60. {imageio-2.37.0 → imageio-2.37.2}/tests/test_swf.py +1 -2
  61. {imageio-2.37.0 → imageio-2.37.2}/tests/test_tifffile.py +1 -2
  62. {imageio-2.37.0 → imageio-2.37.2}/tests/test_tifffile_v3.py +1 -2
  63. imageio-2.37.0/PKG-INFO +0 -84
  64. imageio-2.37.0/imageio.egg-info/PKG-INFO +0 -84
  65. imageio-2.37.0/setup.cfg +0 -19
  66. imageio-2.37.0/setup.py +0 -173
  67. {imageio-2.37.0 → imageio-2.37.2}/CONTRIBUTORS.txt +0 -0
  68. {imageio-2.37.0/imageio.egg-info → imageio-2.37.2/ImageIO.egg-info}/dependency_links.txt +0 -0
  69. {imageio-2.37.0/imageio.egg-info → imageio-2.37.2/ImageIO.egg-info}/entry_points.txt +0 -0
  70. {imageio-2.37.0/imageio.egg-info → imageio-2.37.2/ImageIO.egg-info}/not-zip-safe +0 -0
  71. {imageio-2.37.0/imageio.egg-info → imageio-2.37.2/ImageIO.egg-info}/top_level.txt +0 -0
  72. {imageio-2.37.0 → imageio-2.37.2}/MANIFEST.in +0 -0
  73. {imageio-2.37.0 → imageio-2.37.2}/README.md +0 -0
  74. {imageio-2.37.0 → imageio-2.37.2}/docs/Makefile +0 -0
  75. {imageio-2.37.0 → imageio-2.37.2}/docs/_static/imageio_logo.png +0 -0
  76. {imageio-2.37.0 → imageio-2.37.2}/docs/_templates/better_class.rst +0 -0
  77. {imageio-2.37.0 → imageio-2.37.2}/docs/_templates/formats.rst.template +0 -0
  78. {imageio-2.37.0 → imageio-2.37.2}/docs/_templates/plugin.rst +0 -0
  79. {imageio-2.37.0 → imageio-2.37.2}/docs/conf.py +0 -0
  80. {imageio-2.37.0 → imageio-2.37.2}/docs/development/index.rst +0 -0
  81. {imageio-2.37.0 → imageio-2.37.2}/docs/development/plugins.rst +0 -0
  82. {imageio-2.37.0 → imageio-2.37.2}/docs/formats/formats_by_plugin.rst +0 -0
  83. {imageio-2.37.0 → imageio-2.37.2}/docs/formats/index.rst +0 -0
  84. {imageio-2.37.0 → imageio-2.37.2}/docs/formats/video_formats.rst +0 -0
  85. {imageio-2.37.0 → imageio-2.37.2}/docs/index.rst +0 -0
  86. {imageio-2.37.0 → imageio-2.37.2}/docs/make.bat +0 -0
  87. {imageio-2.37.0 → imageio-2.37.2}/docs/reference/core_v3.rst +0 -0
  88. {imageio-2.37.0 → imageio-2.37.2}/docs/reference/index.rst +0 -0
  89. {imageio-2.37.0 → imageio-2.37.2}/docs/reference/userapi.rst +0 -0
  90. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/cmdlinescripts.rst +0 -0
  91. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/envvariables.rst +0 -0
  92. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/freezing.rst +0 -0
  93. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/index.rst +0 -0
  94. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/installation.rst +0 -0
  95. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/overview.rst +0 -0
  96. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/scipy.rst +0 -0
  97. {imageio-2.37.0 → imageio-2.37.2}/docs/user_guide/standardimages.rst +0 -0
  98. {imageio-2.37.0 → imageio-2.37.2}/imageio/config/__init__.py +0 -0
  99. {imageio-2.37.0 → imageio-2.37.2}/imageio/config/plugins.py +0 -0
  100. {imageio-2.37.0 → imageio-2.37.2}/imageio/config/plugins.pyi +0 -0
  101. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/format.py +0 -0
  102. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/format.pyi +0 -0
  103. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/imopen.py +0 -0
  104. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/imopen.pyi +0 -0
  105. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/legacy_plugin_wrapper.py +0 -0
  106. {imageio-2.37.0 → imageio-2.37.2}/imageio/core/v3_plugin_api.py +0 -0
  107. {imageio-2.37.0 → imageio-2.37.2}/imageio/freeze.py +0 -0
  108. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/__init__.py +0 -0
  109. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/_bsdf.py +0 -0
  110. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/_swf.py +0 -0
  111. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/dicom.py +0 -0
  112. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/feisem.py +0 -0
  113. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/fits.py +0 -0
  114. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/freeimage.py +0 -0
  115. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/grab.py +0 -0
  116. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/npz.py +0 -0
  117. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/opencv.py +0 -0
  118. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/pillow_info.py +0 -0
  119. {imageio-2.37.0 → imageio-2.37.2}/imageio/plugins/tifffile_v3.py +0 -0
  120. {imageio-2.37.0 → imageio-2.37.2}/imageio/py.typed +0 -0
  121. {imageio-2.37.0 → imageio-2.37.2}/imageio/typing.py +0 -0
  122. {imageio-2.37.0 → imageio-2.37.2}/imageio/v2.py +0 -0
  123. {imageio-2.37.0 → imageio-2.37.2}/imageio/v3.py +0 -0
  124. {imageio-2.37.0 → imageio-2.37.2}/tests/conftest.py +0 -0
  125. {imageio-2.37.0 → imageio-2.37.2}/tests/test_config.py +0 -0
  126. {imageio-2.37.0 → imageio-2.37.2}/tests/test_fei_tiff.py +0 -0
  127. {imageio-2.37.0 → imageio-2.37.2}/tests/test_format.py +0 -0
  128. {imageio-2.37.0 → imageio-2.37.2}/tests/test_grab.py +0 -0
  129. {imageio-2.37.0 → imageio-2.37.2}/tests/test_legacy_plugin_wrapper.py +0 -0
  130. {imageio-2.37.0 → imageio-2.37.2}/tests/test_opencv.py +0 -0
  131. {imageio-2.37.0 → imageio-2.37.2}/tests/test_spe.py +0 -0
  132. {imageio-2.37.0 → imageio-2.37.2}/tests/test_v2.py +0 -0
@@ -0,0 +1,238 @@
1
+ Metadata-Version: 2.4
2
+ Name: ImageIO
3
+ Version: 2.37.2
4
+ Summary: Read and write images and video across all major formats. Supports scientific and volumetric data.
5
+ Author: ImageIO contributors
6
+ Maintainer-email: Sebastian Wallkotter <sebastian@wallkoetter.net>, Almar Klein <almar.klein@gmail.com>
7
+ License-Expression: BSD-2-Clause
8
+ Project-URL: homepage, https://github.com/imageio/imageio
9
+ Project-URL: download, http://pypi.python.org/pypi/imageio
10
+ Project-URL: source, https://github.com/imageio/imageio
11
+ Project-URL: documentation, https://imageio.readthedocs.io
12
+ Keywords: image,video,imread,imwrite,io,animation,ffmpeg,image processing,numpy,format conversion,scientific imaging,medical imaging,volumetric,video encoding,multimedia,gif,tiff,png,jpeg
13
+ Classifier: Development Status :: 5 - Production/Stable
14
+ Classifier: Intended Audience :: Science/Research
15
+ Classifier: Intended Audience :: Education
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Operating System :: MacOS :: MacOS X
18
+ Classifier: Operating System :: Microsoft :: Windows
19
+ Classifier: Operating System :: POSIX
20
+ Classifier: Programming Language :: Python :: 3
21
+ Classifier: Programming Language :: Python :: 3.10
22
+ Classifier: Programming Language :: Python :: 3.11
23
+ Classifier: Programming Language :: Python :: 3.12
24
+ Classifier: Programming Language :: Python :: 3.13
25
+ Classifier: Programming Language :: Python :: 3.14
26
+ Requires-Python: >=3.9
27
+ Description-Content-Type: text/x-rst
28
+ License-File: LICENSE
29
+ Requires-Dist: numpy
30
+ Requires-Dist: pillow>=8.3.2
31
+ Provides-Extra: bsdf
32
+ Provides-Extra: dicom
33
+ Provides-Extra: feisem
34
+ Provides-Extra: ffmpeg
35
+ Requires-Dist: imageio-ffmpeg; extra == "ffmpeg"
36
+ Requires-Dist: psutil; extra == "ffmpeg"
37
+ Provides-Extra: freeimage
38
+ Requires-Dist: fsspec[http]; extra == "freeimage"
39
+ Provides-Extra: lytro
40
+ Provides-Extra: numpy
41
+ Provides-Extra: pillow-heif
42
+ Requires-Dist: pillow-heif; extra == "pillow-heif"
43
+ Provides-Extra: pillow
44
+ Provides-Extra: simpleitk
45
+ Provides-Extra: spe
46
+ Provides-Extra: swf
47
+ Provides-Extra: tifffile
48
+ Requires-Dist: tifffile; extra == "tifffile"
49
+ Provides-Extra: pyav
50
+ Requires-Dist: av; extra == "pyav"
51
+ Provides-Extra: fits
52
+ Requires-Dist: astropy; extra == "fits"
53
+ Provides-Extra: rawpy
54
+ Requires-Dist: rawpy; extra == "rawpy"
55
+ Requires-Dist: numpy>2; extra == "rawpy"
56
+ Provides-Extra: gdal
57
+ Requires-Dist: gdal; extra == "gdal"
58
+ Provides-Extra: itk
59
+ Requires-Dist: itk; extra == "itk"
60
+ Provides-Extra: linting
61
+ Requires-Dist: black; extra == "linting"
62
+ Requires-Dist: flake8; extra == "linting"
63
+ Provides-Extra: test
64
+ Requires-Dist: pytest; extra == "test"
65
+ Requires-Dist: pytest-cov; extra == "test"
66
+ Requires-Dist: fsspec[github]; extra == "test"
67
+ Provides-Extra: docs
68
+ Requires-Dist: sphinx<6; extra == "docs"
69
+ Requires-Dist: numpydoc; extra == "docs"
70
+ Requires-Dist: pydata-sphinx-theme; extra == "docs"
71
+ Provides-Extra: dev
72
+ Requires-Dist: pytest; extra == "dev"
73
+ Requires-Dist: pytest-cov; extra == "dev"
74
+ Requires-Dist: fsspec[github]; extra == "dev"
75
+ Requires-Dist: black; extra == "dev"
76
+ Requires-Dist: flake8; extra == "dev"
77
+ Provides-Extra: all-plugins
78
+ Requires-Dist: av; extra == "all-plugins"
79
+ Requires-Dist: astropy; extra == "all-plugins"
80
+ Requires-Dist: fsspec[http]; extra == "all-plugins"
81
+ Requires-Dist: imageio-ffmpeg; extra == "all-plugins"
82
+ Requires-Dist: numpy>2; extra == "all-plugins"
83
+ Requires-Dist: pillow-heif; extra == "all-plugins"
84
+ Requires-Dist: psutil; extra == "all-plugins"
85
+ Requires-Dist: rawpy; extra == "all-plugins"
86
+ Requires-Dist: tifffile; extra == "all-plugins"
87
+ Provides-Extra: all-plugins-pypy
88
+ Requires-Dist: fsspec[http]; extra == "all-plugins-pypy"
89
+ Requires-Dist: imageio-ffmpeg; extra == "all-plugins-pypy"
90
+ Requires-Dist: pillow-heif; extra == "all-plugins-pypy"
91
+ Requires-Dist: psutil; extra == "all-plugins-pypy"
92
+ Requires-Dist: tifffile; extra == "all-plugins-pypy"
93
+ Provides-Extra: full
94
+ Requires-Dist: astropy; extra == "full"
95
+ Requires-Dist: av; extra == "full"
96
+ Requires-Dist: black; extra == "full"
97
+ Requires-Dist: flake8; extra == "full"
98
+ Requires-Dist: fsspec[github,http]; extra == "full"
99
+ Requires-Dist: imageio-ffmpeg; extra == "full"
100
+ Requires-Dist: numpydoc; extra == "full"
101
+ Requires-Dist: numpy>2; extra == "full"
102
+ Requires-Dist: pillow-heif; extra == "full"
103
+ Requires-Dist: psutil; extra == "full"
104
+ Requires-Dist: pydata-sphinx-theme; extra == "full"
105
+ Requires-Dist: pytest; extra == "full"
106
+ Requires-Dist: pytest-cov; extra == "full"
107
+ Requires-Dist: rawpy; extra == "full"
108
+ Requires-Dist: sphinx<6; extra == "full"
109
+ Requires-Dist: tifffile; extra == "full"
110
+ Dynamic: license-file
111
+
112
+ # IMAGEIO
113
+
114
+ [![CI](https://github.com/imageio/imageio/workflows/CI/badge.svg)](https://github.com/imageio/imageio/actions/workflows/ci.yml)
115
+ [![CD](https://github.com/imageio/imageio/workflows/CD/badge.svg)](https://github.com/imageio/imageio/actions/workflows/cd.yml)
116
+ [![codecov](https://codecov.io/gh/imageio/imageio/branch/master/graph/badge.svg?token=81Zhu9MDec)](https://codecov.io/gh/imageio/imageio)
117
+ [![Docs](https://readthedocs.org/projects/imageio/badge/?version=latest)](https://imageio.readthedocs.io)
118
+
119
+ [![Supported Python Versions](https://img.shields.io/pypi/pyversions/imageio.svg)](https://pypi.python.org/pypi/imageio/)
120
+ [![PyPI Version](https://img.shields.io/pypi/v/imageio.svg)](https://pypi.python.org/pypi/imageio/)
121
+ ![PyPI Downloads](https://img.shields.io/pypi/dm/imageio?color=blue)
122
+ [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1488561.svg)](https://doi.org/10.5281/zenodo.1488561)
123
+
124
+ Website: <https://imageio.readthedocs.io/>
125
+
126
+ Imageio is a mature Python library that makes it easy to read and write image
127
+ and video data. This includes animated images, video, volumetric data, and
128
+ scientific formats. It is cross-platform, runs on Python 3.9+, and is easy to
129
+ install.
130
+
131
+ Professional support is available via
132
+ [Tidelift](https://tidelift.com/funding/github/pypi/imageio).
133
+
134
+ ## Example
135
+
136
+ Here's a minimal example of how to use imageio. See the docs for [more
137
+ examples](https://imageio.readthedocs.io/en/stable/examples.html).
138
+
139
+ ```python
140
+ import imageio.v3 as iio
141
+ im = iio.imread('imageio:chelsea.png') # read a standard image
142
+ im.shape # im is a NumPy array of shape (300, 451, 3)
143
+ iio.imwrite('chelsea.jpg', im) # convert to jpg
144
+ ```
145
+
146
+ ## API in a nutshell
147
+
148
+ You just have to remember a handful of functions:
149
+
150
+ ```python
151
+ imread() # for reading
152
+ imwrite() # for writing
153
+ imiter() # for iterating image series (animations/videos/OME-TIFF/...)
154
+ improps() # for standardized metadata
155
+ immeta() # for format-specific metadata
156
+ imopen() # for advanced usage
157
+ ```
158
+
159
+ See the [API docs](https://imageio.readthedocs.io/en/stable/reference/index.html) for more information.
160
+
161
+ ## Features
162
+
163
+ - Simple interface via a concise set of functions
164
+ - Easy to
165
+ [install](https://imageio.readthedocs.io/en/stable/getting_started/installation.html)
166
+ using Conda or pip
167
+ - Few core dependencies (only NumPy and Pillow)
168
+ - Pure Python, runs on Python 3.9+, and PyPy
169
+ - Cross platform, runs on Windows, Linux, macOS
170
+ - More than 295 supported
171
+ [formats](https://imageio.readthedocs.io/en/stable/formats/index.html)
172
+ - Read/Write support for various
173
+ [resources](https://imageio.readthedocs.io/en/stable/getting_started/requests.html)
174
+ (files, URLs, bytes, FileLike objects, ...)
175
+ - High code quality and large test suite including functional, regression, and
176
+ integration tests
177
+
178
+ ## Dependencies
179
+
180
+ Minimal requirements:
181
+
182
+ - Python 3.9+
183
+ - NumPy
184
+ - Pillow >= 8.3.2
185
+
186
+ Optional Python packages:
187
+
188
+ - imageio-ffmpeg (for working with video files)
189
+ - pyav (for working with video files)
190
+ - tifffile (for working with TIFF files)
191
+ - itk or SimpleITK (for ITK plugin)
192
+ - astropy (for FITS plugin)
193
+ - [imageio-flif](https://codeberg.org/monilophyta/imageio-flif) (for working
194
+ with [FLIF](https://github.com/FLIF-hub/FLIF) image files)
195
+
196
+ ## Security contact information
197
+
198
+ To report a security vulnerability, please use the [Tidelift security
199
+ contact](https://tidelift.com/security). Tidelift will coordinate the fix and
200
+ disclosure.
201
+
202
+ ## ImageIO for enterprise
203
+
204
+ Available as part of the Tidelift Subscription.
205
+
206
+ The maintainers of imageio and thousands of other packages are working with
207
+ Tidelift to deliver commercial support and maintenance for the open source
208
+ dependencies you use to build your applications. Save time, reduce risk, and
209
+ improve code health, while paying the maintainers of the exact dependencies you
210
+ use. ([Learn
211
+ more](https://tidelift.com/subscription/pkg/pypi-imageio?utm_source=pypi-imageio&utm_medium=referral&utm_campaign=readme))
212
+
213
+ ## Details
214
+
215
+ The core of ImageIO is a set of user-facing APIs combined with a plugin manager.
216
+ API calls choose sensible defaults and then call the plugin manager, which
217
+ deduces the correct plugin/backend to use for the given resource and file
218
+ format. The plugin manager adds sensible backend-specific defaults and then
219
+ calls one of ImageIOs many backends to perform the actual loading. This allows
220
+ ImageIO to take care of most of the gory details of loading images for you,
221
+ while still allowing you to customize the behavior when and where you need to.
222
+ You can find a more detailed explanation of this process in [our
223
+ documentation](https://imageio.readthedocs.io/en/stable/user_guide/overview.html).
224
+
225
+ ## Contributing
226
+
227
+ We welcome contributions of any kind. Here are some suggestions on how you are
228
+ able to contribute
229
+
230
+ - add missing formats to the format list
231
+ - suggest/implement support for new backends
232
+ - report/fix any bugs you encounter while using ImageIO
233
+
234
+ To assist you in getting started with contributing code, take a look at the
235
+ [development
236
+ section](https://imageio.readthedocs.io/en/stable/development/index.html) of the
237
+ docs. You will find instructions on setting up the dev environment as well as
238
+ examples on how to contribute code.
@@ -2,8 +2,15 @@ CONTRIBUTORS.txt
2
2
  LICENSE
3
3
  MANIFEST.in
4
4
  README.md
5
+ pyproject.toml
5
6
  setup.cfg
6
- setup.py
7
+ ImageIO.egg-info/PKG-INFO
8
+ ImageIO.egg-info/SOURCES.txt
9
+ ImageIO.egg-info/dependency_links.txt
10
+ ImageIO.egg-info/entry_points.txt
11
+ ImageIO.egg-info/not-zip-safe
12
+ ImageIO.egg-info/requires.txt
13
+ ImageIO.egg-info/top_level.txt
7
14
  docs/Makefile
8
15
  docs/conf.py
9
16
  docs/examples.rst
@@ -42,13 +49,6 @@ imageio/v2.py
42
49
  imageio/v2.pyi
43
50
  imageio/v3.py
44
51
  imageio/v3.pyi
45
- imageio.egg-info/PKG-INFO
46
- imageio.egg-info/SOURCES.txt
47
- imageio.egg-info/dependency_links.txt
48
- imageio.egg-info/entry_points.txt
49
- imageio.egg-info/not-zip-safe
50
- imageio.egg-info/requires.txt
51
- imageio.egg-info/top_level.txt
52
52
  imageio/config/__init__.py
53
53
  imageio/config/extensions.py
54
54
  imageio/config/extensions.pyi
@@ -2,8 +2,9 @@ numpy
2
2
  pillow>=8.3.2
3
3
 
4
4
  [all-plugins]
5
- astropy
6
5
  av
6
+ astropy
7
+ fsspec[http]
7
8
  imageio-ffmpeg
8
9
  numpy>2
9
10
  pillow-heif
@@ -12,7 +13,7 @@ rawpy
12
13
  tifffile
13
14
 
14
15
  [all-plugins-pypy]
15
- av
16
+ fsspec[http]
16
17
  imageio-ffmpeg
17
18
  pillow-heif
18
19
  psutil
@@ -20,9 +21,6 @@ tifffile
20
21
 
21
22
  [bsdf]
22
23
 
23
- [build]
24
- wheel
25
-
26
24
  [dev]
27
25
  pytest
28
26
  pytest-cov
@@ -47,18 +45,17 @@ psutil
47
45
  astropy
48
46
 
49
47
  [freeimage]
48
+ fsspec[http]
50
49
 
51
50
  [full]
52
51
  astropy
53
52
  av
54
53
  black
55
54
  flake8
56
- fsspec[github]
57
- gdal
55
+ fsspec[github,http]
58
56
  imageio-ffmpeg
59
- itk
60
- numpy>2
61
57
  numpydoc
58
+ numpy>2
62
59
  pillow-heif
63
60
  psutil
64
61
  pydata-sphinx-theme
@@ -67,7 +64,6 @@ pytest-cov
67
64
  rawpy
68
65
  sphinx<6
69
66
  tifffile
70
- wheel
71
67
 
72
68
  [gdal]
73
69
  gdal
@@ -1,4 +1,4 @@
1
- Copyright (c) 2014-2022, imageio developers
1
+ Copyright (c) 2014-2025, imageio developers
2
2
  All rights reserved.
3
3
 
4
4
  Redistribution and use in source and binary forms, with or without
@@ -0,0 +1,238 @@
1
+ Metadata-Version: 2.4
2
+ Name: ImageIO
3
+ Version: 2.37.2
4
+ Summary: Read and write images and video across all major formats. Supports scientific and volumetric data.
5
+ Author: ImageIO contributors
6
+ Maintainer-email: Sebastian Wallkotter <sebastian@wallkoetter.net>, Almar Klein <almar.klein@gmail.com>
7
+ License-Expression: BSD-2-Clause
8
+ Project-URL: homepage, https://github.com/imageio/imageio
9
+ Project-URL: download, http://pypi.python.org/pypi/imageio
10
+ Project-URL: source, https://github.com/imageio/imageio
11
+ Project-URL: documentation, https://imageio.readthedocs.io
12
+ Keywords: image,video,imread,imwrite,io,animation,ffmpeg,image processing,numpy,format conversion,scientific imaging,medical imaging,volumetric,video encoding,multimedia,gif,tiff,png,jpeg
13
+ Classifier: Development Status :: 5 - Production/Stable
14
+ Classifier: Intended Audience :: Science/Research
15
+ Classifier: Intended Audience :: Education
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Operating System :: MacOS :: MacOS X
18
+ Classifier: Operating System :: Microsoft :: Windows
19
+ Classifier: Operating System :: POSIX
20
+ Classifier: Programming Language :: Python :: 3
21
+ Classifier: Programming Language :: Python :: 3.10
22
+ Classifier: Programming Language :: Python :: 3.11
23
+ Classifier: Programming Language :: Python :: 3.12
24
+ Classifier: Programming Language :: Python :: 3.13
25
+ Classifier: Programming Language :: Python :: 3.14
26
+ Requires-Python: >=3.9
27
+ Description-Content-Type: text/x-rst
28
+ License-File: LICENSE
29
+ Requires-Dist: numpy
30
+ Requires-Dist: pillow>=8.3.2
31
+ Provides-Extra: bsdf
32
+ Provides-Extra: dicom
33
+ Provides-Extra: feisem
34
+ Provides-Extra: ffmpeg
35
+ Requires-Dist: imageio-ffmpeg; extra == "ffmpeg"
36
+ Requires-Dist: psutil; extra == "ffmpeg"
37
+ Provides-Extra: freeimage
38
+ Requires-Dist: fsspec[http]; extra == "freeimage"
39
+ Provides-Extra: lytro
40
+ Provides-Extra: numpy
41
+ Provides-Extra: pillow-heif
42
+ Requires-Dist: pillow-heif; extra == "pillow-heif"
43
+ Provides-Extra: pillow
44
+ Provides-Extra: simpleitk
45
+ Provides-Extra: spe
46
+ Provides-Extra: swf
47
+ Provides-Extra: tifffile
48
+ Requires-Dist: tifffile; extra == "tifffile"
49
+ Provides-Extra: pyav
50
+ Requires-Dist: av; extra == "pyav"
51
+ Provides-Extra: fits
52
+ Requires-Dist: astropy; extra == "fits"
53
+ Provides-Extra: rawpy
54
+ Requires-Dist: rawpy; extra == "rawpy"
55
+ Requires-Dist: numpy>2; extra == "rawpy"
56
+ Provides-Extra: gdal
57
+ Requires-Dist: gdal; extra == "gdal"
58
+ Provides-Extra: itk
59
+ Requires-Dist: itk; extra == "itk"
60
+ Provides-Extra: linting
61
+ Requires-Dist: black; extra == "linting"
62
+ Requires-Dist: flake8; extra == "linting"
63
+ Provides-Extra: test
64
+ Requires-Dist: pytest; extra == "test"
65
+ Requires-Dist: pytest-cov; extra == "test"
66
+ Requires-Dist: fsspec[github]; extra == "test"
67
+ Provides-Extra: docs
68
+ Requires-Dist: sphinx<6; extra == "docs"
69
+ Requires-Dist: numpydoc; extra == "docs"
70
+ Requires-Dist: pydata-sphinx-theme; extra == "docs"
71
+ Provides-Extra: dev
72
+ Requires-Dist: pytest; extra == "dev"
73
+ Requires-Dist: pytest-cov; extra == "dev"
74
+ Requires-Dist: fsspec[github]; extra == "dev"
75
+ Requires-Dist: black; extra == "dev"
76
+ Requires-Dist: flake8; extra == "dev"
77
+ Provides-Extra: all-plugins
78
+ Requires-Dist: av; extra == "all-plugins"
79
+ Requires-Dist: astropy; extra == "all-plugins"
80
+ Requires-Dist: fsspec[http]; extra == "all-plugins"
81
+ Requires-Dist: imageio-ffmpeg; extra == "all-plugins"
82
+ Requires-Dist: numpy>2; extra == "all-plugins"
83
+ Requires-Dist: pillow-heif; extra == "all-plugins"
84
+ Requires-Dist: psutil; extra == "all-plugins"
85
+ Requires-Dist: rawpy; extra == "all-plugins"
86
+ Requires-Dist: tifffile; extra == "all-plugins"
87
+ Provides-Extra: all-plugins-pypy
88
+ Requires-Dist: fsspec[http]; extra == "all-plugins-pypy"
89
+ Requires-Dist: imageio-ffmpeg; extra == "all-plugins-pypy"
90
+ Requires-Dist: pillow-heif; extra == "all-plugins-pypy"
91
+ Requires-Dist: psutil; extra == "all-plugins-pypy"
92
+ Requires-Dist: tifffile; extra == "all-plugins-pypy"
93
+ Provides-Extra: full
94
+ Requires-Dist: astropy; extra == "full"
95
+ Requires-Dist: av; extra == "full"
96
+ Requires-Dist: black; extra == "full"
97
+ Requires-Dist: flake8; extra == "full"
98
+ Requires-Dist: fsspec[github,http]; extra == "full"
99
+ Requires-Dist: imageio-ffmpeg; extra == "full"
100
+ Requires-Dist: numpydoc; extra == "full"
101
+ Requires-Dist: numpy>2; extra == "full"
102
+ Requires-Dist: pillow-heif; extra == "full"
103
+ Requires-Dist: psutil; extra == "full"
104
+ Requires-Dist: pydata-sphinx-theme; extra == "full"
105
+ Requires-Dist: pytest; extra == "full"
106
+ Requires-Dist: pytest-cov; extra == "full"
107
+ Requires-Dist: rawpy; extra == "full"
108
+ Requires-Dist: sphinx<6; extra == "full"
109
+ Requires-Dist: tifffile; extra == "full"
110
+ Dynamic: license-file
111
+
112
+ # IMAGEIO
113
+
114
+ [![CI](https://github.com/imageio/imageio/workflows/CI/badge.svg)](https://github.com/imageio/imageio/actions/workflows/ci.yml)
115
+ [![CD](https://github.com/imageio/imageio/workflows/CD/badge.svg)](https://github.com/imageio/imageio/actions/workflows/cd.yml)
116
+ [![codecov](https://codecov.io/gh/imageio/imageio/branch/master/graph/badge.svg?token=81Zhu9MDec)](https://codecov.io/gh/imageio/imageio)
117
+ [![Docs](https://readthedocs.org/projects/imageio/badge/?version=latest)](https://imageio.readthedocs.io)
118
+
119
+ [![Supported Python Versions](https://img.shields.io/pypi/pyversions/imageio.svg)](https://pypi.python.org/pypi/imageio/)
120
+ [![PyPI Version](https://img.shields.io/pypi/v/imageio.svg)](https://pypi.python.org/pypi/imageio/)
121
+ ![PyPI Downloads](https://img.shields.io/pypi/dm/imageio?color=blue)
122
+ [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1488561.svg)](https://doi.org/10.5281/zenodo.1488561)
123
+
124
+ Website: <https://imageio.readthedocs.io/>
125
+
126
+ Imageio is a mature Python library that makes it easy to read and write image
127
+ and video data. This includes animated images, video, volumetric data, and
128
+ scientific formats. It is cross-platform, runs on Python 3.9+, and is easy to
129
+ install.
130
+
131
+ Professional support is available via
132
+ [Tidelift](https://tidelift.com/funding/github/pypi/imageio).
133
+
134
+ ## Example
135
+
136
+ Here's a minimal example of how to use imageio. See the docs for [more
137
+ examples](https://imageio.readthedocs.io/en/stable/examples.html).
138
+
139
+ ```python
140
+ import imageio.v3 as iio
141
+ im = iio.imread('imageio:chelsea.png') # read a standard image
142
+ im.shape # im is a NumPy array of shape (300, 451, 3)
143
+ iio.imwrite('chelsea.jpg', im) # convert to jpg
144
+ ```
145
+
146
+ ## API in a nutshell
147
+
148
+ You just have to remember a handful of functions:
149
+
150
+ ```python
151
+ imread() # for reading
152
+ imwrite() # for writing
153
+ imiter() # for iterating image series (animations/videos/OME-TIFF/...)
154
+ improps() # for standardized metadata
155
+ immeta() # for format-specific metadata
156
+ imopen() # for advanced usage
157
+ ```
158
+
159
+ See the [API docs](https://imageio.readthedocs.io/en/stable/reference/index.html) for more information.
160
+
161
+ ## Features
162
+
163
+ - Simple interface via a concise set of functions
164
+ - Easy to
165
+ [install](https://imageio.readthedocs.io/en/stable/getting_started/installation.html)
166
+ using Conda or pip
167
+ - Few core dependencies (only NumPy and Pillow)
168
+ - Pure Python, runs on Python 3.9+, and PyPy
169
+ - Cross platform, runs on Windows, Linux, macOS
170
+ - More than 295 supported
171
+ [formats](https://imageio.readthedocs.io/en/stable/formats/index.html)
172
+ - Read/Write support for various
173
+ [resources](https://imageio.readthedocs.io/en/stable/getting_started/requests.html)
174
+ (files, URLs, bytes, FileLike objects, ...)
175
+ - High code quality and large test suite including functional, regression, and
176
+ integration tests
177
+
178
+ ## Dependencies
179
+
180
+ Minimal requirements:
181
+
182
+ - Python 3.9+
183
+ - NumPy
184
+ - Pillow >= 8.3.2
185
+
186
+ Optional Python packages:
187
+
188
+ - imageio-ffmpeg (for working with video files)
189
+ - pyav (for working with video files)
190
+ - tifffile (for working with TIFF files)
191
+ - itk or SimpleITK (for ITK plugin)
192
+ - astropy (for FITS plugin)
193
+ - [imageio-flif](https://codeberg.org/monilophyta/imageio-flif) (for working
194
+ with [FLIF](https://github.com/FLIF-hub/FLIF) image files)
195
+
196
+ ## Security contact information
197
+
198
+ To report a security vulnerability, please use the [Tidelift security
199
+ contact](https://tidelift.com/security). Tidelift will coordinate the fix and
200
+ disclosure.
201
+
202
+ ## ImageIO for enterprise
203
+
204
+ Available as part of the Tidelift Subscription.
205
+
206
+ The maintainers of imageio and thousands of other packages are working with
207
+ Tidelift to deliver commercial support and maintenance for the open source
208
+ dependencies you use to build your applications. Save time, reduce risk, and
209
+ improve code health, while paying the maintainers of the exact dependencies you
210
+ use. ([Learn
211
+ more](https://tidelift.com/subscription/pkg/pypi-imageio?utm_source=pypi-imageio&utm_medium=referral&utm_campaign=readme))
212
+
213
+ ## Details
214
+
215
+ The core of ImageIO is a set of user-facing APIs combined with a plugin manager.
216
+ API calls choose sensible defaults and then call the plugin manager, which
217
+ deduces the correct plugin/backend to use for the given resource and file
218
+ format. The plugin manager adds sensible backend-specific defaults and then
219
+ calls one of ImageIOs many backends to perform the actual loading. This allows
220
+ ImageIO to take care of most of the gory details of loading images for you,
221
+ while still allowing you to customize the behavior when and where you need to.
222
+ You can find a more detailed explanation of this process in [our
223
+ documentation](https://imageio.readthedocs.io/en/stable/user_guide/overview.html).
224
+
225
+ ## Contributing
226
+
227
+ We welcome contributions of any kind. Here are some suggestions on how you are
228
+ able to contribute
229
+
230
+ - add missing formats to the format list
231
+ - suggest/implement support for new backends
232
+ - report/fix any bugs you encounter while using ImageIO
233
+
234
+ To assist you in getting started with contributing code, take a look at the
235
+ [development
236
+ section](https://imageio.readthedocs.io/en/stable/development/index.html) of the
237
+ docs. You will find instructions on setting up the dev environment as well as
238
+ examples on how to contribute code.
@@ -45,7 +45,7 @@ Imageio can read from filenames, file objects.
45
45
 
46
46
 
47
47
  # from HTTPS
48
- web_image = "https://upload.wikimedia.org/wikipedia/commons/d/d3/Newtons_cradle_animation_book_2.gif"
48
+ web_image = "https://raw.githubusercontent.com/imageio/test_images/refs/heads/main/newtonscradle.gif"
49
49
  frames = iio.imread(web_image, index=None)
50
50
 
51
51
  # from bytes
@@ -1,5 +1,4 @@
1
- """ Invoke various functionality for imageio docs.
2
- """
1
+ """Invoke various functionality for imageio docs."""
3
2
 
4
3
  from pathlib import Path
5
4
 
@@ -1,5 +1,5 @@
1
- Depreciating Python 2.7
2
- =======================
1
+ Deprecating Python 2.7
2
+ ======================
3
3
 
4
4
  Python 2.7 is deprecated from 2020. For more information on the
5
5
  scientific Python ecosystem's transition to Python3 only, see the
@@ -103,7 +103,7 @@ Webcam
103
103
  .. note::
104
104
  To access your webcam you will need to have the ffmpeg backend installed::
105
105
 
106
- pip install imageio[ffmpeg]
106
+ pip install "imageio[ffmpeg]"
107
107
 
108
108
  With ImageIO you can directly read images (frame-by-frame) from a webcam that is
109
109
  connected to the computer. To do this, you can use the special target::
@@ -16,7 +16,10 @@ Main website: https://imageio.readthedocs.io/
16
16
 
17
17
  # flake8: noqa
18
18
 
19
- __version__ = "2.37.0"
19
+ from importlib.metadata import version as get_version
20
+
21
+ __version__ = get_version("imageio")
22
+
20
23
 
21
24
  import warnings
22
25
 
@@ -44,11 +44,9 @@ def download_bin(plugin_names=["all"], package_dir=False):
44
44
  print("Ascertaining binaries for: {}.".format(", ".join(plugin_names)))
45
45
 
46
46
  if package_dir:
47
- # Download the binaries to the `resources` directory
48
- # of imageio. If imageio comes as an .egg, then a cache
49
- # directory will be created by pkg_resources (requires setuptools).
47
+ # Download the binaries to the `resources` directory of imageio.
50
48
  # see `imageio.core.util.resource_dirs`
51
- # and `imageio.core.utilresource_package_dir`
49
+ # and `imageio.core.util.resource_package_dir`
52
50
  directory = util.resource_package_dir()
53
51
  else:
54
52
  directory = None
@@ -57,7 +57,7 @@ class FileExtension:
57
57
  name=None,
58
58
  description=None,
59
59
  external_link=None,
60
- volume_support=False
60
+ volume_support=False,
61
61
  ):
62
62
  self.extension = extension
63
63
  self.priority = priority
@@ -15,7 +15,7 @@ class FileExtension:
15
15
  priority: List[str],
16
16
  name: str = None,
17
17
  description: str = None,
18
- external_link: str = None
18
+ external_link: str = None,
19
19
  ) -> None: ...
20
20
  def reset(self) -> None: ...
21
21
 
@@ -1,7 +1,7 @@
1
1
  # -*- coding: utf-8 -*-
2
2
  # Distributed under the (new) BSD License. See LICENSE.txt for more info.
3
3
 
4
- """ This subpackage provides the core functionality of imageio
4
+ """This subpackage provides the core functionality of imageio
5
5
  (everything but the plugins).
6
6
  """
7
7
 
@@ -2,8 +2,7 @@
2
2
  # Based on code from the vispy project
3
3
  # Distributed under the (new) BSD License. See LICENSE.txt for more info.
4
4
 
5
- """Data downloading and reading functions
6
- """
5
+ """Data downloading and reading functions"""
7
6
 
8
7
  from math import log
9
8
  import os