NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2586 most downloaded on PyPI
Faster zlib and gzip compatible compression and decompression by providing python bindings for the ISA-L ibrary.
Latest stable
1.9.1
Last release 19 days ago
03 Nov 2026
Release timing varies
gaps range from 2 weeks to 1.1 years
Nearly every release is documented
notes for 26 of 26 stable releases
7 versions withdrawn
withdrawn after publishing
6 years old
33 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Fix BrokenPipeError when piping python -m isal.igzip into head , less or similar programs.
python -m isal.igzip into head,less or similar programs.By far most of the work on this release has been done by @ptweezy <https://github.com/ptweezy> _. Almost all bug fixes and improvements are their work
By far most of the work on this release has been done by
@ptweezy <https://github.com/ptweezy>_. Almost all bug fixes and improvements
are their work.
Major changes:
Optimizations and features:
isal_zlib.compressobj supports strategy=Z_FIXED at compressionflush(Z_SYNC_FLUSH), compress to an average of 75 insteadZ_FIXEDimport isal.igzip and import isal.igzip_threaded byargparse and shutil only when the command line interfacemultiprocessing import.igzip files through iteration,readlines(), and readline(). On an Apple M4, reading FASTQ data iswrite() call to binary igzip files on CPython. On anigzip.IGzipFile on Python 3.12 and later.IGzipFile collects these writes in the write buffer ofgzip.GzipFile and compresses them in large chunks, which makes writingBug fixes:
igzip.decompress gets an object that is notstr. It raises a TypeError instead.igzip_lib.IgzipDecompressor objects with azdict.isal.isal_zlib or isal.igzip_lib, for example, the main interpreterPy_NewInterpreter() creates. Eachexcept isal_zlib.error, except igzip_lib.error, andexcept gzip.BadGzipFile caught errors only in the interpreter thatisal_zlib.Compress: after flush() raised an error forflush(Z_FINISH) twice on a level 0isal_zlib.Compress object.unused_data of isal_zlib.Decompress andigzip_lib.IgzipDecompressor, which could contain bytes from outside themax_length split the end of a stream. At the end of aisal_zlib.Decompress.unconsumed_tail is empty, matching theigzip_lib.IgzipDecompressor.needs_input, which could be Truedecompress() returned max_length bytes while more output wasneeds_input is True, such as CPython's DecompressReader, raisedEOFError for valid data.isal_zlib.decompressobj with a wbits of 40 to 47, which detectsdecompress()isal_zlib.decompressobj with a wbits of 40 to 47 after aflush() call that came before any data. It then failed on both zlib andigzip_threaded.open raises ValueError for a block_size of aboutTypeError for a compresslevel that is not anSystemError before.igzip_threaded writers at compression level 0, which raisedOverflowError for data that does not compress, such as random bytes orblock_size must now beOverflowError rather than use more and moreigzip_threaded readers and writers that waited for a polling timeoutigzip_threaded writers that waited forever when writing to thewrite(), flush(), or close() raises the error. After an error,close() no longer closes a file object that you passed toigzip_threaded.open.igzip_threaded writers with more than one thread that waitedwrite(), flush(), or close()unused_data or unconsumed_tail of an isal_zlib decompressorisal_zlib decompressors and igzip_lib.IgzipDecompressor from otherdecompress() from severalwbits detects the format.isal_zlib.crc32_combine and the read() and seek() methods of theisal_zlib._GzipReader class raise TypeError instead ofSystemError for arguments of the wrong type or number.igzip.IGzipFile was not affected.isal_zlib.Compress orisal_zlib.Decompress object by calling the type, for example,isal_zlib.Compress(), and then use it. Calling the type raisesTypeError now, as it does on CPython. Use compressobj() anddecompressobj() instead.readinto() of the private isal_zlib._GzipReader class, whichbytes. It raises TypeError now.igzip.IGzipFile was not affected.mtime attribute of igzip.IGzipFile objects in read mode,None for gzip files with a modification time of 0. It is 0 now,gzip module. gzip -n, python -m isal.igzip -n, andigzip_threaded writers make such files, and so does gzip.compress byigzip_lib.IgzipDecompressor. It raises MemoryError now.BadGzipFile forigzip.decompress.MemoryError now.igzip_lib.IgzipDecompressor.decompress() after a call onMemoryError. The next call used the input of theisal_zlib.Compress, isal_zlib.Decompress, origzip_lib.IgzipDecompressor object. It raises MemoryError now.-0 and --fast options of python -m isal.igzip, whichseek() of theisal_zlib._GzipReader class while another thread reads from theigzip.IGzipFile was not affected.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Python 3.8 and 3.9 are no longer supported.
Use upstream ISA-L version 2.31.1 which includes patches to make installation on MacOS ARM64 possible.
Fix a bug where flushing files when writing in threaded mode did not work properly.
Include a patched ISA-L version 2.31. The applied patches make compilation and wheelbuilding on MacOS ARM64 possible.
igzip.compress function, which should leadFix a bug where streams that were passed to igzip_threaded.open where closed.
Fix a bug where compression levels for IGzipFile where checked in read mode.
__close__ function when a threadedFix a bug where append mode would not work when using igzip_threaded.open .
igzip_threaded.open.Fix a bug where a filehandle remained opened when igzip_threaded.open was used for writing with a wrong compression level.
igzip_threaded.openFix a memory leak in the GzipReader.readall implementation.
Make a special case for threads==1 in igzip_threaded.open for writing files. This now combines the writing and compression thread for less overhead.
igzip_threaded.open for writingigzip_threaded.open writing.Fix several errors related to unclosed files and buffers.
Drop support for python 3.7 and PyPy 3.8 as these are no longer supported. Add testing and support for python 3.12 and PyPy 3.10.
isal.igzip_threaded module which has an
open function.
This can be used to read and write large files in a streaming fashion
while escaping the GIL.igzip._IGzipReader has been rewritten in C. As a result the
overhead of decompressing files has significantly been reduced and
python -m isal.igzip is now very close to the C igzip application.igzip._IGZipReader in C is now used in igzip.decompress. The
_GzipReader also can read from objects that support the buffer protocol.
This has reduced overhead significantly.Gzip headers are now actively checked for a BGZF extra field. If found the block size is taken into account when decompressing. This has further impro
gzip.decompress function.Bgzip files are now detected and a smaller reading buffer is used to accomodate the fact that bgzip blocks are typically less than 64K. (Unlike normal
isal_zlib.decompressobj and
igzip_lib.IgzipDecompressor.Added tests and support for Python 3.11.
Fixed failing tests and wheel builds for PyPy.
Python-isal has been rewritten as a C-extension (first implementation was in Cython). This has made the library faster in many key areas.
Python-isal has been rewritten as a C-extension (first implementation was in Cython). This has made the library faster in many key areas.
Since the module now mostly contains code copied from CPython and then modified to work with ISA-L the license has been changed to the Python Software Foundation License version 2.
Python versions lower than 3.7 are no longer supported. Python 3.6 is out of support since December 2021.
Stub files with type information have now been updated to correctly display positional-only arguments.
Expose READ and WRITE constants on the igzip module. These are
also present in Python's stdlib gzip module and exposing them allows for
better drop-in capability of igzip. Thanks to @alexander-beedie in
https://github.com/pycompression/python-isal/pull/115.
A --no-name flag has been added to python -m isal.igzip.
Reduced wheel size by not including debug symbols in the binary. Thanks to @marcelm in https://github.com/pycompression/python-isal/pull/108.
Cython is no longer required as a build dependency.
isal_zlib.compressobj and isal_zlib.decompressobj are now about six times faster.
igzip.decompress has 30% less overhead when called.
Error structure has been simplified. There is only IsalError which has
Exception as baseclass instead of OSError. isal_zlib.IsalError,
igzip_lib.IsalError, isal_zlib.error and igzip_lib.error are
all aliases of the same error class.
GzipReader now uses larger input and output buffers (128k) by default and
IgzipDecompressor.decompress has been updated to allocate maxsize buffers
when these are of reasonable size, instead of growing the buffer to maxsize
on every call. This has improved gzip decompression speeds by 7%.
Patch statically linked included library (ISA-L 2.30.0) to fix the following:
Python-isal shows up in Python profiler reports.
Support and tests for Python 3.10 were added.
Due to a change in the deployment process wheels should work for older versions of pip.
Added a crc property to the IgzipDecompressor class. Depending on the
decompression flag chosen, this will update with an adler32 or crc32
checksum.
All the decompression NO_HDR flags on igzip_lib were incorrectly documented. This is now fixed.
Fixed an issue which occurred rarely that caused IgzipDecompressor's unused_data to report back incorrectly. This caused checksum errors when reading
In this release the python -m isal.igzip relatively slow decompression rate has been improved in both speed and usability. Previously it was 19% slowe
In this release the python -m isal.igzip relatively slow decompression rate
has been improved in both speed and usability. Previously it was 19% slower
than igzip when used with the -d flag for decompressing, now it is
just 8% slower. Also some extra flags were added to make it easier to select
the output file.
python -m isal.igzip
command line utility and provide the -f or --force flags to force
overwriting.-o and --output flags to the python -m isal.igzip command
line utility to allow the user to select the destination of the output file.igzip_lib and isal_zlib to disappear in the
documentation and the REPL.python -m isal.igzip so it is now closer
to speeds reached with igzip.READ_BUFFER_SIZE attribute to igzip which allows setting the
amount of raw data that is read at once.igzip_lib.IgzipDecompressor object which can decompress without
using an unconsumed_tail and is therefore more efficient.Added an igzip_lib module which allows more direct access to ISA-L's igzip_lib API. This allows features such as headerless compression and decompress
igzip_lib module which allows more direct access to ISA-L's
igzip_lib API. This allows features such as headerless compression and
decompression, as well as setting the memory levels manually.Fix a bug where a AttributeError was triggered when zlib.Z_RLE or zlib.Z_FIXED were not present.
Fix a bug where multi-member gzip files where read incorrectly due to an offset error. This was caused by ISA-L's decompressobj having a small bitbuff
Due to changes in this version igzip.compress, igzip.decompress, isal_zlib.compress, isal_zlib.crc32 and isal_zlib.adler32 perform always faster than
Due to changes in this version igzip.compress, igzip.decompress, isal_zlib.compress, isal_zlib.crc32 and isal_zlib.adler32 perform always faster than their gzip and zlib counterparts. isal_zlib.decompress is still slower for very small data <128 bytes, but faster in all other cases.
igzip.compress and igzip.decompress by improving the
implementation.isal_zlib library was removed:
ISAL_DEFAULT_HIST_BITS.This release fixes several bugs in isal_zlib. It now is a proper drop-in replacement for zlib. This is a major milestone towards the 1.0.0 release.
This release fixes several bugs in isal_zlib. It now is a proper drop-in replacement for zlib. This is a major milestone towards the 1.0.0 release.
igzip module for the unconsumed_tail
and unused_data bugs. igzip._IGzipReader now functions the same
as gzip._GzipReader with only a few calls replaced with isal_zlib
calls for speed.unused_data and unconsumed_tail on
isal_zlib.Decompress objects.
It works the same as in CPython's zlib now.isal_zlib.Compress and
isal_zlib.Decompress objects.
It works the same as in CPython's zlib now.Fix a crash that occurs when opening a file that did not end in .gz while outputting to stdout using python -m isal.igzip.
.gz while
outputting to stdout using python -m isal.igzip.Python-isal is now cross-platform thanks to adding Windows support in this release.
Python-isal is now cross-platform thanks to adding Windows support in this release.
python -m gzip's behaviour has been changed since fixing bug:
bpo-43316 <https://bugs.python.org/issue43316>_. This bug was not present
in python -m isal.igzip but it handled the error differently than the
solution in CPython. This is now corrected and python -m isal.igzip
handles the error the same as the fixed python -m gzip.Fix a bug where negative integers were not allowed for the adler32 and crc32 functions in isal_zlib.
adler32 and
crc32 functions in isal_zlib.isal_zlib and _isal modules.
Package is now tested with mypy to ensure correct type information.-b flag was added to adjust the buffer size for benchmarks.-c or --stdout flag was added to the CLI interface of isal.igzip.
This allows it to behave more like the gzip or pigz command line
interfaces.Move wheel building to cibuildwheel on github actions CI. Wheels are now provided for Mac OS as well.
Set included ISA-L library at version 2.30.0.
Fixed a bug where writing of the gzip header would crash if an older version of Python 3.7 was used such as on Debian or Ubuntu. This is due to differ
setup.py to list setuptools as a requirement.The first release for python-isal includes a implementation of the igzip module that is compliant with the tests for CPython's gzip module. The zlib m
The first release for python-isal includes a implementation of the igzip module that is compliant with the tests for CPython's gzip module. The zlib module has still some issues. This release was made to allow easy installation for people who want to enjoy the speed improvements of the igzip module over the gzip module.
python -m isal.igzipOne column per quarter.