From ca7a0efbaad726ddd4bb74e14210c8a79a58cebe Mon Sep 17 00:00:00 2001 From: Drishti Gupta Date: Sun, 4 Jan 2026 15:40:37 +0530 Subject: [PATCH 1/2] docs: add Apple Silicon warning to CONTRIBUTING.rst --- CONTRIBUTING.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index c16ecdeed9e..056e7dcef22 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -132,6 +132,29 @@ To set up ScanCode for local development: libraries (from the `thirdparty/ directory`), setup the paths, etc. See https://virtualenv.pypa.io/en/latest/ for more details. + .. warning:: + + **Apple Silicon (M1/M2/M3/M4) users** + + Due to missing ARM64 wheels for some native dependencies, the contributor + setup may fail when using ARM-native Python. + + Use an x86_64 Python installation under Rosetta and configure ScanCode to + use it explicitly: + + .. code-block:: bash + + # Install x86_64 Python via Rosetta + arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + arch -x86_64 /usr/local/bin/brew install python@3.12 + + # Tell configure to use it + echo "/usr/local/bin/python3.12" > PYTHON_EXECUTABLE + ./configure --dev + + See issue #3205 for more context on Apple Silicon compatibility. + + Run this command to configure ScanCode:: ./configure --dev From 08450c5afba9898cd87438c061f3010cd6e40a7a Mon Sep 17 00:00:00 2001 From: Drishti Gupta Date: Fri, 9 Jan 2026 18:41:49 +0530 Subject: [PATCH 2/2] docs: simplify Apple Silicon warning per maintainer feedback --- CONTRIBUTING.rst | 18 +++++------------- 1 file changed, 5 insertions(+), 13 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 056e7dcef22..280d61bafac 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -139,20 +139,12 @@ To set up ScanCode for local development: Due to missing ARM64 wheels for some native dependencies, the contributor setup may fail when using ARM-native Python. - Use an x86_64 Python installation under Rosetta and configure ScanCode to - use it explicitly: + Use an x86_64 Python installation under Rosetta and configure ScanCode + to use it explicitly before running ``./configure --dev``. - .. code-block:: bash - - # Install x86_64 Python via Rosetta - arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - arch -x86_64 /usr/local/bin/brew install python@3.12 - - # Tell configure to use it - echo "/usr/local/bin/python3.12" > PYTHON_EXECUTABLE - ./configure --dev - - See issue #3205 for more context on Apple Silicon compatibility. + See the Homebrew and Python documentation for installing x86_64 Python + under Rosetta, and issue #3205 for more context on Apple Silicon + compatibility. Run this command to configure ScanCode::