A perpetual PR for running regression tests

.clang-tidy

@@ -0,0 +1 @@
+Checks: 'performance-*, modernize-*, misc-*, -misc-definitions-in-headers, -misc-non-private-member-variables-in-classes, -misc-no-recursion, -misc-include-cleaner, -misc-use-anonymous-namespace, -modernize-use-trailing-return-type, -modernize-use-nodiscard, -modernize-use-emplace, -modernize-loop-convert, -modernize-pass-by-value, -modernize-use-equals-delete, -modernize-use-equals-default, -modernize-use-override, -modernize-avoid-c-arrays, -modernize-raw-string-literal, -modernize-concat-nested-namespaces, -performance-inefficient-string-concatenation'

.github/workflows/build-cppfront.yaml

@@ -1,26 +1,40 @@
 name: Multi-platform Build of cppfront
+
 on:
-  push:
-    branches:
-      - main
   pull_request:
-    branches:
-      - main
+    paths-ignore:
+      - 'docs/**'
+  push:
+    paths-ignore:
+      - 'docs/**'
+  workflow_dispatch:
+
+permissions:
+  # Restrict permissions to read-only for security
+  contents: read
+
+concurrency:
+  # Specific group name to cancel in-progress builds for the same PR/ref
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
-  build-windows:
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: ilammy/msvc-dev-cmd@v1
-      - name: Compiler name & version
-        run: cl.exe
-      - name: Build
-        run: cl.exe source/cppfront.cpp -std:c++latest -MD -EHsc -experimental:module -W4 -WX
+  # Comment out the Windows build until it is fixed
+  # build-windows:
+  #   runs-on: windows-latest
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #     - uses: ilammy/msvc-dev-cmd@v1
+  #     - name: Compiler name & version
+  #       run: cl.exe
+  #     - name: Build
+  #       run: cl.exe source/cppfront.cpp -std:c++latest -MD -EHsc -W4 -WX
+
   build-unix-like:
     strategy:
       fail-fast: false
       matrix:
-        runs-on: [ubuntu-latest]
+        runs-on: [ubuntu-22.04]
         compiler: [g++-10, g++-11, g++-12, clang++-12, clang++-14]
         cxx-std: ['c++20', 'c++2b']
         exclude:
@@ -33,18 +47,36 @@ jobs:
           - compiler: clang++-14
             cxx-std: 'c++2b'
         include:
-          - runs-on: macos-11
+          - runs-on: macos-14
             compiler: clang++
             cxx-std: 'c++20'
-          - runs-on: macos-latest
+          - runs-on: macos-15
             compiler: clang++
             cxx-std: 'c++20'
+          - runs-on: ubuntu-22.04
+            compiler: clang++-15
+            cxx-std: 'c++20'
+          - runs-on: ubuntu-24.04
+            compiler: clang++-16
+            cxx-std: 'c++20'
+          - runs-on: ubuntu-24.04
+            compiler: clang++-17
+            cxx-std: 'c++20'
+          - runs-on: ubuntu-24.04
+            compiler: clang++-18
+            cxx-std: 'c++20'
+          - runs-on: ubuntu-24.04
+            compiler: clang++-18
+            cxx-std: 'c++23'
+          - runs-on: ubuntu-24.04
+            compiler: g++-14
+            cxx-std: 'c++2b'
     runs-on: ${{ matrix.runs-on }}
     env:
       CXX: ${{ matrix.compiler }}
       CXXFLAGS: -std=${{ matrix.cxx-std }} -Wall -Wextra -Wold-style-cast -Wunused-parameter -Wpedantic -Werror -pthread -Wno-unknown-warning -Wno-unknown-warning-option
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Install compiler
       if: startsWith(matrix.runs-on, 'ubuntu')
       run: sudo apt-get install -y $CXX

.github/workflows/docs.yml

@@ -0,0 +1,21 @@
+name: docs
+on:
+  push:
+    branches:
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - uses: actions/cache@v4
+        with:
+          key: ${{ github.ref }}
+          path: .cache
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

.github/workflows/regression-tests.yaml

@@ -0,0 +1,136 @@
+name: Regression tests
+
+on:
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+  push:
+    paths-ignore:
+      - 'docs/**'
+  workflow_dispatch:
+
+permissions:
+  # Restrict permissions to read-only for security
+  contents: read
+
+concurrency:
+  # Specific group name to cancel in-progress builds for the same PR/ref
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  regression-tests:
+    name: ${{ matrix.shortosname }} | ${{ matrix.compiler }} | ${{ matrix.cxx_std }} | ${{ matrix.stdlib }} | ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    env:
+      CXX: ${{ matrix.compiler }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04]
+        shortosname: [ubu-24]
+        compiler: [g++-14, g++-13]
+        cxx_std: [c++2b]
+        stdlib: [libstdc++]
+        include:
+          - os: ubuntu-24.04
+            shortosname: ubu-24
+            compiler: clang++-19
+            cxx_std: c++20
+            stdlib: libstdc++
+          - os: ubuntu-24.04
+            shortosname: ubu-24
+            compiler: clang++-19
+            cxx_std: c++23
+            stdlib: libc++-18-dev
+          - os: ubuntu-22.04
+            shortosname: ubu-22
+            compiler: clang++-15
+            cxx_std: c++20
+            stdlib: libstdc++
+          - os: ubuntu-22.04
+            shortosname: ubu-22
+            compiler: clang++-15
+            cxx_std: c++20
+            stdlib: libc++-15-dev
+          - os: macos-14
+            shortosname: mac-14
+            compiler: clang++
+            cxx_std: c++2b
+            stdlib: default
+          # Comment out Windows tests until build on Windows is fixed
+          # - os: windows-2025
+          #   shortosname: win-25
+          #   compiler: cl.exe
+          #   cxx_std: c++latest
+          #   stdlib: default
+          # - os: windows-2025
+          #   shortosname: win-25
+          #   compiler: cl.exe
+          #   cxx_std: c++20
+          #   stdlib: default
+    steps:
+    - name: Checkout repo
+      uses: actions/checkout@v4
+
+    - name: Prepare compilers - macOS
+      if: matrix.os == 'macos-13'
+      run: |
+        sudo xcode-select --switch /Applications/Xcode_14.3.1.app
+        sudo ln -s "$(brew --prefix llvm@15)/bin/clang" /usr/local/bin/clang++-15
+
+    - name: Prepare compilers - Ubuntu 24.04
+      if: matrix.os == 'ubuntu-24.04'
+      run: |
+        sudo sudo apt-get install clang-19
+
+    - name: Run regression tests - Linux and macOS version
+      if: startsWith(matrix.os, 'ubuntu') || startsWith(matrix.os, 'macos')
+      run: |
+        cd regression-tests
+        bash run-tests.sh -c ${{ matrix.compiler }} -s ${{ matrix.cxx_std }} -d ${{ matrix.stdlib }} -l ${{ matrix.os }}
+
+    - name: Run regression tests - Windows version
+      if: startsWith(matrix.os, 'windows')
+      run: |
+        "C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Auxiliary\Build\vcvars64.bat" && ^
+        git config --local core.autocrlf false && ^
+        cd regression-tests && ^
+        bash run-tests.sh -c ${{ matrix.compiler }} -s ${{ matrix.cxx_std }} -d ${{ matrix.stdlib }} -l ${{ matrix.os }}
+      shell: cmd
+
+    - name: Upload patch
+      if: success() || failure()
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ matrix.os }}-${{ matrix.compiler }}-${{ matrix.cxx_std }}-${{ matrix.stdlib }}.patch
+        path: regression-tests/${{ matrix.os }}-${{ matrix.compiler }}-${{ matrix.cxx_std }}-${{ matrix.stdlib }}.patch
+        if-no-files-found: ignore
+
+  aggregate-results:
+    needs: regression-tests
+    if:  success() || failure()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download all patches
+        uses: actions/download-artifact@v4
+        with:
+          path: downloaded-results
+
+      - name: Prepare result files
+        id: prepare_files
+        run: |
+          mkdir aggregated-results
+          echo "Flattening file hierarchy"
+          find . -type f -wholename "./downloaded-results*" -exec mv {} aggregated-results \;
+          patch_count=$(ls aggregated-results 2>/dev/null | wc -l)
+          echo "patch_count=${patch_count}" >> $GITHUB_OUTPUT
+
+      - name: Upload aggregated results
+        if: steps.prepare_files.outputs.patch_count != '0'
+        uses: actions/upload-artifact@v4
+        with:
+          name: aggregated-results
+          path: aggregated-results
+          if-no-files-found: ignore

.gitignore

@@ -9,6 +9,7 @@
 *.tlog
 *.idb
 *.obj
+*.ifc
 *.pdb
 *.suo
 *.db
@@ -27,9 +28,21 @@
 *.exe
 source/gen_version.bat
 build*/
+venv/*
+*.ifc
 
 # Visual Studio cache directory
 .vs/
 
 # VSCode workspace directory
 .vscode/
+buildh2.bat
+gen_version.bat
+mkdocs_serve.sh
+experimental/a.out
+cppfront/x64/Debug/microsoft/STL/std.compat.ixx.ifc.dt.d.json
+cppfront/x64/Debug/microsoft/STL/std.compat.ixx.ifc.dt.module.json
+cppfront/x64/Debug/microsoft/STL/std.compat.ixx.ifc.dt.module.json.command
+cppfront/x64/Debug/microsoft/STL/std.ixx.ifc.dt.d.json
+cppfront/x64/Debug/microsoft/STL/std.ixx.ifc.dt.module.json
+cppfront/x64/Debug/microsoft/STL/std.ixx.ifc.dt.module.json.command

CITATION.cff

@@ -0,0 +1,12 @@
+cff-version: 1.2.0
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+title: cppfront
+authors:
+  - given-names: Herb
+    family-names: Sutter
+repository-code: 'https://github.com/hsutter/cppfront'
+abstract: A personal experimental C++ Syntax 2 -> Syntax 1 compiler
+license: Apache-2.0 WITH LLVM-exception

CODE_OF_CONDUCT.md

@@ -1,10 +1,6 @@
 # cppfront
 
-An experimental C++ Syntax 2 -> Syntax 1 transpiler
-
-Copyright (c) Herb Sutter
-SPDX-License-Identifier: CC-BY-NC-ND-4.0
-See [License](LICENSE)
+This project is an experimental C++ Syntax 2 -> Syntax 1 transpiler, copyright (c) Herb Sutter • See [License](LICENSE)
 
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
 

CONTRIBUTING.md

@@ -1,9 +1,10 @@
 
-This is the contributor license agreement. If you are looking for the usage license, see here: [usage license](https://github.com/hsutter/cppfront/blob/main/LICENSE)
+## Contributing
 
-## cppfront Contributor License Agreement
+This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant  the rights to use your contribution. A sample of the CLA is below.
 
-By contributing content to cppfront (i.e., submitting a pull request for inclusion in this repository):
-- You warrant that your material is original, or you have the right to contribute it.
-- With respect to the material that you own, you grant a worldwide, non-exclusive, irrevocable, transferable, and royalty-free license to your contributed material to Herb Sutter to display, reproduce, perform, distribute, and create derivative works of that material for commercial or non-commercial use.
-- With respect to any other material you contribute, such material must be under a worldwide, non-exclusive, irrevocable, transferable, and royalty-free license sufficient to allow Herb Sutter to display, reproduce, perform, distribute, and create derivative works of that material for commercial or non-commercial use.
+When you submit a pull request, a CLA bot or human will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided. You will only need to do this once for all your contributions to cppfront.
+
+## Cppfront Contribution License Agreement (Sample)
+
+A sample can be found here: [Cppfront CLA 2024-10 - sample.pdf](docs/Cppfront CLA 2024-10 - sample.pdf)