BLD: build docs on macOS

.github/workflows/main.yml

@@ -87,10 +87,6 @@ jobs:
       run: |
         pip install .
     - name: Check that docs can be built
-      # note we don't build this on macOS because the GHA python is built with
-      # the wrong version of macOS, confusing clang.
-      # See: https://github.com/actions/virtual-environments/issues/696
-      if: startsWith(matrix.os, 'ubuntu')
       run: |
         pip install sphinx sphinx_rtd_theme breathe ipython
         make docs

docs/source/tutorial/setup.py

@@ -1,6 +1,7 @@
 import ast
 import glob
 import os
+import sys
 
 from libpy.build import LibpyExtension
 from setuptools import find_packages, setup
@@ -16,13 +17,18 @@
 
 
 def extension(*args, **kwargs):
+    extra_compile_args = []
+    if sys.platform == 'darwin':
+        extra_compile_args.append('-mmacosx-version-min=10.15')
+
     return LibpyExtension(
         *args,
         optlevel=optlevel,
         debug_symbols=debug_symbols,
         werror=True,
         max_errors=max_errors,
         include_dirs=["."] + kwargs.pop("include_dirs", []),
+        extra_compile_args=extra_compile_args,
         depends=glob.glob("**/*.h", recursive=True),
         **kwargs
     )