Fix PyPI with macos-latest and improve docs

.github/workflows/pypi.yml

@@ -74,6 +74,7 @@ jobs:
           echo "CPPFLAGS=-I$PREFIX/include" >> "$GITHUB_ENV"
           echo "LDFLAGS=-L$PREFIX/lib" >> "$GITHUB_ENV"
           echo "CMAKE_PREFIX_PATH=$PREFIX" >> "$GITHUB_ENV"
+          echo "OpenMP_ROOT=$PREFIX" >> "$GITHUB_ENV"
 
       - name: Build wheels
         uses: pypa/cibuildwheel@v3.4.1

CITATION.cff

@@ -8,8 +8,8 @@ authors:
     given-names: "Marco"
     orcid: "https://orcid.org/0000-0003-4033-4956"
 title: "quantlop"
-version: 0.1.0
-date-released: 2026-08-03
+version: 0.1.1
+date-released: 2026-08-04
 license: "Apache-2.0"
 repository-code: "https://github.com/SimoneGasperini/quantlop"
 url: "https://github.com/SimoneGasperini/quantlop"

CMakeLists.txt

@@ -1,6 +1,26 @@
 cmake_minimum_required(VERSION 3.18)
 
-project(quantlop VERSION 0.1.0 LANGUAGES CXX)
+project(quantlop VERSION 0.1.1 LANGUAGES CXX)
+
+if(APPLE AND NOT OpenMP_ROOT)
+    find_program(BREW_EXECUTABLE brew)
+    find_program(PORT_EXECUTABLE port)
+
+    if(BREW_EXECUTABLE)
+        execute_process(
+            COMMAND "${BREW_EXECUTABLE}" --prefix libomp
+            OUTPUT_VARIABLE OpenMP_ROOT
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            RESULT_VARIABLE BREW_LIBOMP_RESULT
+        )
+
+        if(NOT BREW_LIBOMP_RESULT EQUAL 0)
+            unset(OpenMP_ROOT)
+        endif()
+    elseif(PORT_EXECUTABLE AND EXISTS "/opt/local")
+        set(OpenMP_ROOT "/opt/local")
+    endif()
+endif()
 
 find_package(OpenMP REQUIRED)
 

docs/development.rst

@@ -15,6 +15,16 @@ the development and documentation dependencies:
 
    python -m pip install -e .[dev,docs]
 
+.. WARNING:: 
+   If you are on macOS, you need first to install ``libomp`` with either 
+   `Homebrew <https://brew.sh/>`_ or `MacPorts <https://www.macports.org/>`_:
+
+   .. code-block:: console
+
+      brew install libomp
+      # or
+      sudo port install libomp +top_level
+
 Run the Python test suite with:
 
 .. code-block:: console
@@ -42,7 +52,7 @@ Install the pre-commit hooks to format Python and C++ files automatically:
 
 .. code-block:: console
 
-   pre-commit install
+   python -m pre_commit install
 
 Build docs
 ----------

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "quantlop"
-version = "0.1.0"
+version = "0.1.1"
 description = "High-performance quantum simulator for matrix-free Hamiltonian evolution"
 readme = "README.md"
 license = "Apache-2.0"