Skip to content

miurahr/pybcj

Repository files navigation

BCJ(Branch-Call-Jump) filter for python

https://img.shields.io/conda/vn/conda-forge/pybcj https://dev.azure.com/miurahr/CodeBerg/_apis/build/status/CodeBerg-pybcj-CI?branchName=main https://coveralls.io/repos/github/miurahr/pybcj/badge.svg?branch=main

In data compression, BCJ, short for Branch-Call-Jump, refers to a technique that improves the compression of machine code of executable binaries by replacing relative branch addresses with absolute ones. This allows a LZMA compressor to identify duplicate targets and archive higher compression rate.

BCJ is used in 7-zip compression utility as default filter for executable binaries.

pybcj is a python bindings with BCJ implementation by C language. The C codes are derived from p7zip, portable 7-zip implementation. pybcj support Intel/Amd x86/x86_64, Arm/Arm64, ArmThumb, Sparc, PPC, and IA64.

Development status

A development status is considered as Beta state.

Installation

As usual, you can install pybcj using python standard pip command.

pip install pybcj

Alternatively, one can also use conda:

conda install -c conda-forge pybcj

WARNING

  • When use it on MSYS2/Mingw64 environment, please set environment variable SETUPTOOLS_USE_DISTUTILS=stdlib to install.

License

  • Copyright (C) 2020-2022 Hiroshi Miura
  • Copyright (C) 1999-2010 Igor Pavlov