Add repair wheel manylinux

Author: michelerenzullo

.github/workflows/ci.yml

@@ -172,6 +172,32 @@ jobs:
           push: true
           tags: ${{ secrets.DOCKER_USERNAME }}/libgaussianblur:${{ env.BUILD_TARGET }}
 
+      - name: Pull manylinux image if not cached
+        run: |
+          if [ -f ".docker/.cache-${{ env.BUILD_TARGET }}/manylinux_2_34_x86_64.tar" ]; then
+            echo "Loading manylinux image from cache..."
+            docker load < .docker/.cache-${{ env.BUILD_TARGET }}/manylinux_2_34_x86_64.tar
+          else
+            echo "Pulling manylinux image..."
+            docker pull quay.io/pypa/manylinux_2_34_x86_64
+            echo "Saving manylinux image to cache..."
+            mkdir -p .docker/.cache-${{ env.BUILD_TARGET }}
+            docker save quay.io/pypa/manylinux_2_34_x86_64 > .docker/.cache-${{ env.BUILD_TARGET }}/manylinux_2_34_x86_64.tar
+          fi
+    
+      - name: Repair Python wheels with auditwheel
+        run: |
+          docker run --rm \
+            -v "$(pwd)/output-${{ env.BUILD_TARGET }}/app/external/${{ env.BUILD_TARGET }}/x86_64/python:/io" \
+            quay.io/pypa/manylinux_2_34_x86_64 \
+            bash -c "set -e; \
+              auditwheel repair /io/*.whl; \
+              repaired_wheel=\$(ls /wheelhouse/*.whl); \
+              echo \"Found repaired wheel: \$repaired_wheel\"; \
+              cp \$repaired_wheel /io/\$(basename \$repaired_wheel); \
+              chown -R $(id -u):$(id -g) /io/\$(basename \$repaired_wheel); \
+              echo \"Wheel copied as: /io/\$(basename \$repaired_wheel)\""
+
       - name: Save docker linux if cache miss
         if: steps.cache-docker-restore.outputs.cache-hit != 'true'
         uses: actions/cache/save@v4

README.md

@@ -198,16 +198,30 @@ make
 
 ## Usage in Python
 
-  If you build the library with `WITH_BINDINGS=ON`, a Python wheel will be generated. You will find the wheel under `external/PLATFORM/ABI/python/` along with the shared library.
+  If you build the library with `WITH_BINDINGS=ON`, a Python wheel will be generated. You will find the wheel under `external/PLATFORM/ABI/python/` along with the shared library.  
+
+  Alternatively, you can install the library directly from [PyPI](https://pypi.org/project/gaussianblur/):
+
+```sh
+pip install gaussianblur
+```
+
 
 A basic example has been provided about how to use the module.  
 First, install the wheel with pip, and then, replace with your input/output image paths:
 
 ```sh
-pip3 install gaussianblur*.whl
+pip install gaussianblur*.whl
 python3 examples/python/main.py
 ```
 
+Note: In the GitHub CI/CD pipeline, the Python wheel is audited by pulling the [manylinux](https://github.com/pypa/manylinux) Docker image and running [auditwheel](https://github.com/pypa/auditwheel). This ensures that all required system shared libraries are bundled within the wheel, meeting the latest PyPI requirements for cross-distribution compatibility on Linux.
+At present, this auditing process is implemented **only** for Linux, as it is the primary platform where bindings are built in the CI/CD pipeline.
+
+If you wish to perform this process locally on macOS, you can use [delocate](https://github.com/matthew-brett/delocate) to audit and repair the wheel.
+
+In the future, I may also consider integrating [cibuildwheel](https://github.com/pypa/cibuildwheel) into the pipeline to streamline the process across multiple platforms, but this is currently a secondary priority.
+
 ## Usage in C++
 
   When building with `WITH_EXAMPLES=ON`, you can try the library. These examples are intended to provide a simple idea of how the library is used.  

bootstrap/bootstrap.gaussianblur.sh

@@ -5,7 +5,7 @@
 
 PREFIX="gaussian_blur"
 TEMP_EXTERNAL_BUILD_DIR=.deps
-GAUSSIANBLUR_VERSION="1.1.1"
+GAUSSIANBLUR_VERSION="1.1.2"
 GAUSSIANBLUR_FOLDER="v${GAUSSIANBLUR_VERSION}"
 GAUSSIANBLUR_BUILD_DIR="${PREFIX}-${GAUSSIANBLUR_FOLDER}"
 

python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gaussianblur"
-version = "1.1.1"
+version = "1.1.2"
 authors = [
   { name="Michele Renzullo", email="[email protected]" },
 ]

python/setup.py

@@ -14,7 +14,7 @@
 try:
     setup(
         name='gaussianblur',
-        version='1.1.1',
+        version='1.1.2',
         packages=find_packages(),
         package_data={'gaussianblur': [
             'gaussianblur.cpython*.so',