Fix CMakeLists.txt, macOS guide and refactor .gitignore

[Vdaleke]

Increase CMake minimum required version to 3.15 due to incompatibilities
with scikit-build-core. Update README.md.

Add POLICY checks to avoid errors on policy-unsupported versions.

Change CMP0167 policy of boost searching to OLD due to non-compliance
with "Modern CMake" development patterns. Add "TODO" to fix this later.
Add useful logs to understand what Boost libraries were found by CMake.

Apply sort to .gitignore to improve readability.
Add .DS_Store, which is generated in macOS directories.
Add .cache, which is generated by clangd.

Add python3 to installation guide.
Fix macOS Boost installation guide to work with python module.
Fix default installation directories as root permissions were required.
Change macOS SDK version to compatibility with new version.

[Vdaleke]

By the way, I checked the build with the new SDK and nothing changed. So the need to use the 14 SDK remains the same.

[Vdaleke]

I also comment export DYLD_LIBRARY_PATH. It's architecturally bad solution and not recommended to use.

The problem is that built python module can't find boost dynamic libraries:

>>> import desbordante
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: dlopen(/Users/vdaleke/Documents/desbordante-core/venv/lib/python3.12/site-packages/desbordante.cpython-312-darwin.so, 0x0002): Library not loaded: libboost_container-xgcc14-mt-a64-1_86.dylib
  Referenced from: <5DE266BA-6882-3835-BB89-3E13967FF861> /Users/vdaleke/Documents/desbordante-core/venv/lib/python3.12/site-packages/desbordante.cpython-312-darwin.so
  Reason: tried: 'libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OSlibboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), 'libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/usr/lib/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file, not in dyld cache), '/Users/vdaleke/Documents/desbordante-core/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/Users/vdaleke/Documents/desbordante-core/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/Users/vdaleke/Documents/desbordante-core/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/usr/lib/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file, not in dyld cache)

The reason is that CMake doesn't set LC_LOAD_DYLIB cmd in ABI for boost libraries with correct path:

➜ otool -L /Users/vdaleke/Documents/desbordante-core/venv/lib/python3.12/site-packages/desbordante.cpython-312-darwin.so 
/Users/vdaleke/Documents/desbordante-core/venv/lib/python3.12/site-packages/desbordante.cpython-312-darwin.so:
	libboost_container-xgcc14-mt-a64-1_86.dylib (compatibility version 0.0.0, current version 0.0.0)
	libboost_thread-xgcc14-mt-a64-1_86.dylib (compatibility version 0.0.0, current version 0.0.0)
	libboost_graph-xgcc14-mt-a64-1_86.dylib (compatibility version 0.0.0, current version 0.0.0)
	/opt/homebrew/opt/gcc/lib/gcc/current/libstdc++.6.dylib (compatibility version 7.0.0, current version 7.33.0)
	/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1345.120.2)

I don't know why it's like this and is it possible to force CMake use full paths or rpath-relative paths. I searched enough and couldn't find a solution. I suggest to stay with this solution just to have a working guide for the moment. In next related PR I suggest to focus on porting project to C++ standard to use clang and homebrew Boost on macOS.

[vs9h]

Overall it looks good, I left a few comments and questions.

[vs9h]

Unfortunately, I can't verify whether it is correct to add such an export for DYLD_LIBRARY_PATH. I have not encountered this before.

I have no more comments on the changes, overall it looks good.

[BUYT-1]

After the library is compiled, does it work if DYLD_LIBRARY_PATH is not set?

[Vdaleke]

After the library is compiled, does it work if DYLD_LIBRARY_PATH is not set?

I'm not sure about the meaning of 'does it work', so, as for Desbordante_test it works fine and as for build/target/desbordante.cpython-312-darwin.so which is built by sci-build-core not, the error is like this:

(venv) ➜  target git:(fix/refactor-gitignore-and-readme) ✗ python3                                                           
Python 3.12.5 (v3.12.5:ff3bc82f7c9, Aug  7 2024, 05:32:06) [Clang 13.0.0 (clang-1300.0.29.30)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import desbordante
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: dlopen(/Users/vdaleke/Documents/desbordante-core/build/target/desbordante.cpython-312-darwin.so, 0x0002): Library not loaded: libboost_container-xgcc14-mt-a64-1_86.dylib
  Referenced from: <2B68442A-C7AA-3FFB-A70C-C3B1D6F570A0> /Users/vdaleke/Documents/desbordante-core/build/target/desbordante.cpython-312-darwin.so
  Reason: tried: 'libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OSlibboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), 'libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/usr/lib/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file, not in dyld cache), '/Users/vdaleke/Documents/desbordante-core/build/target/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/Users/vdaleke/Documents/desbordante-core/build/target/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/Users/vdaleke/Documents/desbordante-core/build/target/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file), '/usr/lib/libboost_container-xgcc14-mt-a64-1_86.dylib' (no such file, not in dyld cache)

I absolutely don't know why it works like this and what good ways to fix it. I attach otool -l output for both binaries, where presented cmds for dyld:
Desbordante_test https://pastebin.com/rxwv8xs1
desbordante.cpython-312-darwin.so https://pastebin.com/wq50BcXm

[Vdaleke]

I found some interesting c make variables which may be help to force include @rpath to dynamic libraries paths which is boost, I will try it later

https://gitlab.kitware.com/cmake/community/-/wikis/doc/cmake/RPATH-handling#default-rpath-settings

[Petua41]

Unfortunately, I can't verify whether it is correct to add such an export for DYLD_LIBRARY_PATH. I have not encountered this before.

DYLD_LIBRARY_PATH is equivalent of Linux LD_PATH, so yes, it's needed to be exported like this for ld to find shared libraries installed into /usr/local/lib (which is default path where brew installs them. Also, Boost is installed here).

Another way to do this is to set CMake's LDFLAGS.