Boost: Use Headers instead of building when not required

When building USD without Python, OIIO or VDB, Boost libs aren't required.
In this scenario, it is preferable to just copy over the headers instead and save some time and complexity.

This also has a significant benefit that it allows the core USD build to be supported on platforms that Boost doesn't natively build on yet like iOS and visionOS. It means that the build_usd.py script doesn't need to carry as many patches to Boost itself if someone is just building the core USD library.

This is similar to [PR 2914](PixarAnimationStudios#2914) but can short circuit the entire bootstrap and b2 process, which may still error on platforms that b2 doesn't understand.

Author: dgovil

build_scripts/build_usd.py

@@ -768,8 +768,38 @@ def InstallBoost_Helper(context, force, buildArgs):
         "*/libs/wave/test/testwave/testfiles/utf8-test-*"
     ]
 
-    with CurrentWorkingDirectory(DownloadURL(BOOST_URL, context, force, 
+    headersOnly = not (context.buildOIIO or context.enableOpenVDB or context.buildPython)
+
+    with CurrentWorkingDirectory(DownloadURL(BOOST_URL, context, force,
                                              dontExtract=dontExtract)):
+        if headersOnly:
+            # We don't need all the headers, so we elide some for space
+            accepted = {'assert', 'config', 'core', 'detail', 'function', 'intrusive_ptr', 'iterator', 'lexical_cast',
+                        'mpl', 'exception', 'move', 'container', 'integer', 'range', 'concept', 'noncopyable',
+                        'numeric', 'optional', 'preprocessor', 'smart_ptr', 'variant', 'vmd', 'type', 'utility'}
+
+            def _filteredHeaderCopy(src, dst):
+                """This utility function only copies over headers that meet our criteria"""
+                doCopy = False
+                parent = os.path.dirname(src)
+                # First we copy over any headers that are in the root of the boost dir, but have no associated subdir
+                # We assume these are shared across many boost libs
+                if src.endswith(".hpp") and os.path.basename(parent) == "boost":
+                    lookFor = os.path.join(parent, os.path.splitext(os.path.basename(src))[0])
+                    doCopy = not os.path.exists(lookFor)
+                # For everything else, we check against the accepted list above to see if they're a dir we want
+                if not doCopy:
+                    for accept in accepted:
+                        if f"boost/{accept}" in dst:
+                            doCopy = True
+                            break
+                if doCopy:
+                    return shutil.copy2(src, dst)
+
+            headersDir = os.path.abspath("./boost")
+            CopyDirectory(context, headersDir, "include/boost", copy_function=_filteredHeaderCopy)
+            return
+
         if Windows():
             bootstrap = "bootstrap.bat"
         else: