@@ -26,8 +26,8 @@ Supported compression formats are:
2626- gzip (``.gz ``)
2727- bzip2 (``.bz2 ``)
2828- xz (``.xz ``)
29+ - lz4 (``.lz4 ``)
2930- Zstandard (``.zst ``) (optional)
30- - lz4 (``.lz4 ``) (optional)
3131
3232``xopen `` is compatible with Python versions 3.8 and later.
3333
@@ -141,6 +141,9 @@ built-in support for multithreaded compression.
141141
142142For bz2 files, `pbzip2 (parallel bzip2) <http://compression.great-site.net/pbzip2/ >`_ is used.
143143
144+ For lz4 files, [python lz4](https://python-lz4.readthedocs.io/en/stable/index.html)
145+ package is used.
146+
144147``xopen `` falls back to Python’s built-in functions
145148(``gzip.open ``, ``lzma.open ``, ``bz2.open ``)
146149if none of the other methods can be used.
@@ -181,20 +184,6 @@ program or the Python ``zstandard`` package needs to be installed.
181184To ensure that you get the correct ``zstandard `` version, you can specify the ``zstd `` extra for
182185``xopen ``, that is, install it using ``pip install xopen[zstd] ``.
183186
184- Optional lz4 support
185- --------------------------
186-
187- For reading and writing lz4 (``.lz4 ``) files, either the ``lz4 `` command-line
188- program or the Python ``lz4 `` package needs to be installed.
189-
190- * If the ``threads `` parameter to ``xopen() `` is ``None `` (the default) or any value greater than 0,
191- ``xopen `` uses an external ``lz4 `` process.
192- * If the above fails (because no ``lz4 `` program is available) or if ``threads `` is 0,
193- the ``lz4 `` package is used.
194-
195- To ensure that ``lz4 `` is installed, you can specify the ``lz4 `` extra for
196- ``xopen ``, that is, install it using ``pip install xopen[lz4] ``.
197-
198187
199188Changelog
200189---------
0 commit comments