doublespace 1.0.1

Python extension for doublespace decompression

doublespace

Python C extension for doublespace decompression, based on the libdeds library.

Requirements

Python >= 3.12 is required to use this extension. Additionally not all python implementations support C extensions.

Installation

python3 -m pip install doublespace

Building

You can build this extension using the standard hatch build command. Please ensure that you have the ninja build system installed on your local system or else the build might fail. You can also use the standard hatch test command to execute the unit tests.

You can also use cibuildwheel for building this extension in a manner compatible with the python manylinux specification.

Example

This example uses the decompress function to perform doublespace decompression. Please keep in mind that a output buffer with a mismatched size will result in an exception. Usually the container format used for carrying doublespace-compressed data tells you the size of the decompressed data.

from doublespace import decompress

out = bytearray(255)    # buffer for output data
in = b'\xBE\xEF'        # input data (bogus data)

version: int = decompress(in, out)

print(f"Format version: {version}")
print(f"Result: {out}")