Temporary workaround for pyinstaller/pyinstaller#5491

Add a runtime hook to macOS bundles that patches `ctypes.util.find_library()`
to return the correct OpenGL framwork path. Necessary, to make PyOpenGL work
within the macOS bundles running on macOS Big Sur.

See pyinstaller/pyinstaller#5491 for details.

To commit is to be reverted once PyInstaller has released a fix for this issue.

deployment/deploy_capture/bundle.spec

@@ -52,7 +52,7 @@ if platform.system() == "Darwin":
         pathex=["../../pupil_src/shared_modules/"],
         hiddenimports=hidden_imports,
         hookspath=None,
-        runtime_hooks=None,
+        runtime_hooks=["../find_opengl_bigsur.py"],
         excludes=["matplotlib"],
         datas=data_files_pye3d,
     )

deployment/deploy_player/bundle.spec

@@ -53,7 +53,7 @@ if platform.system() == "Darwin":
         pathex=["../../pupil_src/shared_modules/"],
         hiddenimports=hidden_imports,
         hookspath=None,
-        runtime_hooks=None,
+        runtime_hooks=["../find_opengl_bigsur.py"],
         excludes=["matplotlib"],
         datas=data_files_pye3d,
     )

deployment/deploy_service/bundle.spec

@@ -43,7 +43,7 @@ if platform.system() == "Darwin":
         pathex=["../../pupil_src/shared_modules/"],
         hiddenimports=hidden_imports,
         hookspath=None,
-        runtime_hooks=None,
+        runtime_hooks=["../find_opengl_bigsur.py"],
         excludes=["matplotlib"],
         datas=data_files_pye3d,
     )

deployment/find_opengl_bigsur.py

@@ -0,0 +1,23 @@
+import ctypes.util
+import functools
+
+
+print("Attempting to import OpenGL using patched `ctypes.util.find_library`...")
+_find_library_original = ctypes.util.find_library
+
+@functools.wraps(_find_library_original)
+def _find_library_patched(name):
+    if name == "OpenGL":
+        return "/System/Library/Frameworks/OpenGL.framework/OpenGL"
+    else:
+        return _find_library_original(name)
+
+ctypes.util.find_library = _find_library_patched
+
+import OpenGL.GL
+
+print("OpenGL import successful!")
+print("Restoring original `ctypes.util.find_library`...")
+ctypes.util.find_library = _find_library_original
+del _find_library_patched
+print("Original `ctypes.util.find_library` restored.")