Make: Checking env. variables on macOS

Author: ashvardanian

CONTRIBUTING.md

@@ -100,7 +100,7 @@ Still, you need a virtual environment, and it's recommended to use `uv` to creat
 ```sh
 uv venv --python 3.11           # Or your preferred Python version
 source .venv/bin/activate       # To activate the virtual environment
-pip install -e .                # To build locally from source
+uv pip install -e .             # To build locally from source
 ```
 
 Testing:
@@ -110,7 +110,7 @@ pip install pytest pytest-repeat tabulate    # testing dependencies
 pytest scripts/test.py -s -x -Wd             # to run tests
 
 # to check supported SIMD instructions:
-python -c "import simsimd; print(simsimd.get_capabilities())" 
+python -c "import simsimd; print(simsimd.get_capabilities())"
 ```
 
 Here, `-s` will output the logs.

setup.py

@@ -1,5 +1,7 @@
+# -*- coding: utf-8 -*-
 from __future__ import annotations
 
+import os
 import sys
 import platform
 import tempfile
@@ -12,6 +14,21 @@
 __lib_name__ = "simsimd"
 __version__ = Path("VERSION").read_text().strip()
 
+# --------------------------------------------------------------------------- #
+#  macOS developer‑tools sanity check                                         #
+# --------------------------------------------------------------------------- #
+# Users occasionally end up with DEVELOPER_DIR="public" (or another bogus
+# path) when installing via package managers that sandbox the tool‑chain.  In
+# that state *every* call to `xcrun` fails before the compiler even starts.
+# We proactively unset that var so AppleClang falls back to xcode‑select’s
+# default path.
+# --------------------------------------------------------------------------- #
+if sys.platform == "darwin":
+    _bad_dev_dir = os.environ.get("DEVELOPER_DIR")
+    if _bad_dev_dir and (_bad_dev_dir == "public" or not Path(_bad_dev_dir).exists()):
+        print(f"[SimSIMD] Ignoring invalid DEVELOPER_DIR={_bad_dev_dir!r}")
+        os.environ.pop("DEVELOPER_DIR", None)
+        
 # --------------------------------------------------------------------------- #
 # Compiler and linker flags common across attempts                            #
 # --------------------------------------------------------------------------- #