GIANT CLUSTERFUCK OF A COMMIT

OK, this is epic.  I was basically just trying to a) support Clang and
b) add more test coverage.  _THREE MONTHS_ and a few hundred CI runs
later, this is what I came up with.  I don't know how it ended up being
what it is, but here we go.

Some highlights of the changes:

1) CI builds has been moved to GitHub Actions,
2) the entire notion of a toolchain has been reworked; it now supports
Clang on all platforms.

* .github: this directory contains the GitHub Actions workflow
scripts/actions.  In the process, I created like 6 external GitHub
actions, but it's still pretty massive.  An upside is that it covers
much more platform/toolchain combinations _and_ check a lot of the
expected post-conditions.  TODO: .ci/Makefile is obsolete now, as well
as .travis.yml and .appveyor.yml.

* common.cmake: added Clang support.  In the process, a great deal has
been learned about how CMake works; in particular, static runtime
support has been reworked to be more robust.

* project: the entire notion of a "toolchain" has been reworked.
Instead of a measly --mingw parameter, there's now a separate --toolset
parameter, which allows you to choose between GCC, Clang, MSVC, etc.
Both Boost and CMake build scripts were enhanced greatly to support
Clang and other toolchains in a more robust way.

1 files changed, 69 insertions, 0 deletions

diff --git a/.github/actions/build-example/action.yml b/.github/actions/build-example/action.yml
new file mode 100644
index 0000000..97cc627
--- /dev/null
+++ b/.github/actions/build-example/action.yml
@@ -0,0 +1,69 @@
+name: Build example project
+description: Build example project
+inputs:
+  src-dir:
+    description: Project directory
+    required: true
+  boost-dir:
+    description: Boost directory
+    required: false
+  toolset:
+    description: Toolset to use
+    required: false
+    default: auto
+  platform:
+    description: Target platform
+    required: false
+    default: x64
+  configuration:
+    description: Configuration to build
+    required: false
+    default: Debug
+outputs:
+  install-dir:
+    description: Installation directory
+    value: '${{ steps.install-dir.outputs.path }}'
+runs:
+  using: composite
+  steps:
+    - id: install-dir
+      run: |
+        $src_dir = Resolve-Path '${{ inputs.src-dir }}'
+        $project_name = Split-Path $src_dir -Leaf
+        $install_dir = Join-Path (Split-Path $env:GITHUB_WORKSPACE) "install_$project_name"
+        echo "::set-output name=path::$install_dir"
+      shell: pwsh
+    - run: |
+        $python = 'python'
+        $src_dir = '${{ inputs.src-dir }}'
+        $install_dir = '${{ steps.install-dir.outputs.path }}'
+        $boost_dir = '${{ inputs.boost-dir }}'
+
+        if ($env:CI_HOST_CYGWIN) {
+            $python = 'python3'
+            $src_dir = cygpath.exe -ua $src_dir
+            $install_dir = cygpath.exe -ua $install_dir
+            if ($boost_dir) {
+                $boost_dir = cygpath.exe -ua $boost_dir
+            }
+        }
+
+        $args = @(
+            '--install',
+            $install_dir,
+            '--platform',
+            '${{ inputs.platform }}',
+            '--configuration',
+            '${{ inputs.configuration }}',
+            '--toolset',
+            '${{ inputs.toolset }}'
+        )
+
+        if ($boost_dir) {
+            $args += '--boost',$boost_dir
+        }
+
+        $args += '--',$src_dir
+        $env:VERBOSE = 1
+        & $python -m project.cmake.build $args
+      shell: pwsh