Skip to main content

A multi-threading implementation of Python gzip module

Project description

mgzip

A multi-threading implement of Python gzip module

Using a block indexed GZIP file format to enable compress and decompress in parallel. This implement use 'FEXTRA' to record the index of compressed member, which is defined in offical GZIP file format specification version 4.3, so it is fully compatible with normal GZIP implement.

This module is ~25X faster for compression and ~7X faster for decompression (limited by IO and Python implementation) with a 24 CPUs computer.

In theoretical, compression and decompression acceleration should be linear according to the CPU cores. In fact, the performance is limited by IO and program language implementation.

Usage

Use same method as gzip module

import mgzip

s = "a big string..."

## Use 8 threads to compress.
## None or 0 means using all CPUs (default)
## Compression block size is set to 200MB
with mgzip.open("test.txt.gz", "wt", thread=8, blocksize=2*10**8) as fw:
    fw.write(s)

with mgzip.open("test.txt.gz", "rt", thread=8) as fr:
    assert fr.read(len(s)) == s

Performance

Compression:

Compression Performance

Decompression:

Decompression Performance

Brenchmarked on a 24 cores, 48 threads server (Xeon(R) CPU E5-2650 v4 @ 2.20GHz) with 8.0GB FASTQ text file.

Using parameters thread=42 and blocksize=200000000

Warning

This package only replace the 'GzipFile' class and 'open', 'compress', 'decompress' functions of standard gzip module. It is not well tested for other class and function.

As the first release version, some features are not yet supported, such as seek() and tell(). Any contribution or improvement is appreciated.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mgzip2-0.2.6.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

mgzip2-0.2.6-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

Details for the file mgzip2-0.2.6.tar.gz.

File metadata

  • Download URL: mgzip2-0.2.6.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for mgzip2-0.2.6.tar.gz
Algorithm Hash digest
SHA256 f9ef343eb524c81f72337f94ffe458ba123f1110b754edd84b716d075180d95b
MD5 b061478da50b34ee0bdf5da116ec47ad
BLAKE2b-256 8030eb6acee248e471a31ab8bc288e81d6bbca938c400ef18161688c2efd3449

See more details on using hashes here.

File details

Details for the file mgzip2-0.2.6-py3-none-any.whl.

File metadata

  • Download URL: mgzip2-0.2.6-py3-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for mgzip2-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 edb4610dc23b1a5930a289513a073058110aeba9ea698c1409c7bf5ecf2a45b1
MD5 bf8ec778f9c7fee4f8b5151d651aa6e5
BLAKE2b-256 1bde5f64137c29c6ba641f0763815e36368c93986b242b150691940f2c7987be

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page