Skip to content
This repository has been archived by the owner on Oct 10, 2023. It is now read-only.

This python bindings to libexplode which is a part of pkglib which is a Free Open-Source implementation of PKWare Data Compression Library (DCL) compression format, which itself was ripped out of Ladislav Zezula's StormLib. !!! Migrated to Codeberg 🏔️ !!!

License

Notifications You must be signed in to change notification settings

implode-compression-impls/pkexplode.py

Repository files navigation

pkexplode.py

wheel (GitLab) wheel (GHA via nightly.link) GitLab Build Status GitLab Coverage Coveralls Coverage GitHub Actions Libraries.io Status Code style: antiflash License

We have moved to https://codeberg.org/implode-compression-impls/pkexplode.py, grab new versions there.

Under the disguise of "better security" Micro$oft-owned GitHub has discriminated users of 1FA passwords while having commercial interest in success of FIDO 1FA specifications and Windows Hello implementation which it promotes as a replacement for passwords. It will result in dire consequencies and is competely inacceptable, read why.

If you don't want to participate in harming yourself, it is recommended to follow the lead and migrate somewhere away of GitHub and Micro$oft. Here is the list of alternatives and rationales to do it. If they delete the discussion, there are certain well-known places where you can get a copy of it. Read why you should also leave GitHub.


This are free and Open-Source ctypes-based bindings to libexplode which is a ripped out part of pkglib which is a Free Open-Source implementation of PKWare Data Compression Library (DCL) compression format, which itself was ripped out of StormLib, all of which are by Ladislav Zezula.

Alternatively you can use:

You also can be interested in the compression counterpart, pkimplode.py

Benefits of CTypes-based impl:

  • Supports python versions other than CPython
  • No need to recompile python module after python version upgrade

Drawbacks:

  • performance and overhead may be worse, than in the case of a cext.

Installation

In order to make it work you need a package with libexplode itself installed into your system using your distro package manager. If your distro doesn't provide one, you can build it yourself using CMake CPack from the sources by the link. You will get 3 packages, one with the headers and another one with the shared library. Only the one with the lib is mandatory.

Usage

The package contains multiple functions. They have names matching the regular expression ^decompress(Stream|Bytes(Whole|Chunked))To(Stream|Bytes)$.

The first subgroup describes the type of input argument, the second subgroup describes the type of output.

  • If input is Bytes, then you need
    • Whole, which means that the lib gots a pointer to whole array with compressed data. This is considered to be the optimal input format.
    • Chunked (which means the data are processed in reality by decompressStreamTo$3) was created mainly for convenience of testing.
  • Otherwise it is an object acting like a stream. In this case you can also provide chunkSize, because streams are processed in chunks. Larger the chunk - less the count of chunks in the stream, so less overhead on calls of callbacks, but more memory is needed to store the chunk.

The second subgroup describes the type of the result.

  • The internal type of the result is always a Stream. This is considered to be the optimal output format. It is because we don't know the size of output ahead of time, so have to use streams.
  • Bytes are only for your convenience and just wrap the decompress$1ToStream with a context with BytesIO.

About

This python bindings to libexplode which is a part of pkglib which is a Free Open-Source implementation of PKWare Data Compression Library (DCL) compression format, which itself was ripped out of Ladislav Zezula's StormLib. !!! Migrated to Codeberg 🏔️ !!!

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages