Merge to master for v4.0.0

.gitattributes

@@ -0,0 +1 @@
+extra/single_include/** linguist-generated=true

.github/scripts/compare_benchmarks.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Copyright 2026 Matt Borland
+# Distributed under the Boost Software License, Version 1.0.
+# https://www.boost.org/LICENSE_1_0.txt
+#
+# Reports the data sets in $1 against the numbers committed under
+# doc/modules/ROOT/data and appends the report to the job summary. Run it from
+# the root of the library checkout.
+#
+# This is informational only: shared runners drift by a few percent from run to
+# run, so a slower number is a prompt to look, not a build failure.
+
+set -e
+
+RESULTS=${1:-bench-results}
+
+PYTHON=python3
+if ! command -v python3 > /dev/null 2>&1; then
+    PYTHON=python
+fi
+
+"$PYTHON" doc/render_benchmarks.py --compare "$RESULTS" --summary "${GITHUB_STEP_SUMMARY:-/dev/null}"

.github/scripts/run_benchmarks.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+# Copyright 2026 Matt Borland
+# Distributed under the Boost Software License, Version 1.0.
+# https://www.boost.org/LICENSE_1_0.txt
+#
+# Builds both benchmark drivers in release mode and runs them, leaving u128.json
+# and i128.json in the --out directory. Those two files are exactly what
+# doc/render_benchmarks.py consumes.
+#
+# Run it from the root of a Boost tree that has this library in libs/int128; the
+# include path is every libs/*/include in that tree, so no b2 headers step is
+# needed. The drivers always exit non-zero (the Jamfile declares them run-fail),
+# so success is judged on the data set actually being written.
+#
+# --sources names extra translation units to build alongside the driver, which is
+# how the platforms with no packaged Abseil get one: point --cxxflags at a source
+# checkout and --sources at absl/numeric/int128.cc, the only file of it that
+# absl::uint128 and absl::int128 need.
+#
+#   .github/scripts/run_benchmarks.sh --compiler g++-14 --out /tmp/results
+#   .github/scripts/run_benchmarks.sh --msvc --elements 5000000 --out C:/results
+
+set -e
+
+COMPILER=""
+EXTRA_CXXFLAGS=""
+EXTRA_LDFLAGS=""
+EXTRA_SOURCES=""
+ELEMENTS=20000000
+REPETITIONS=5
+OUT=""
+MSVC=0
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --compiler)    COMPILER="$2"; shift 2 ;;
+        --cxxflags)    EXTRA_CXXFLAGS="$2"; shift 2 ;;
+        --ldflags)     EXTRA_LDFLAGS="$2"; shift 2 ;;
+        --sources)     EXTRA_SOURCES="$2"; shift 2 ;;
+        --elements)    ELEMENTS="$2"; shift 2 ;;
+        --repetitions) REPETITIONS="$2"; shift 2 ;;
+        --out)         OUT="$2"; shift 2 ;;
+        --msvc)        MSVC=1; shift ;;
+        *) echo "unknown argument: $1" >&2; exit 2 ;;
+    esac
+done
+
+if [ -z "$OUT" ]; then
+    echo "error: --out is required" >&2
+    exit 2
+fi
+
+if [ ! -d libs/int128/test ]; then
+    echo "error: run this from the root of a Boost tree holding libs/int128" >&2
+    exit 2
+fi
+
+mkdir -p "$OUT"
+
+# Every dependency is header only from the benchmarks' point of view, so the
+# include path is simply all of the libraries checked out in this tree.
+INCLUDES=""
+for dir in libs/*/include libs/*/*/include; do
+    if [ -d "$dir" ]; then
+        INCLUDES="$INCLUDES -I$dir"
+    fi
+done
+
+for sign in u128 i128; do
+    source_file="libs/int128/test/benchmark_$sign.cpp"
+
+    if [ "$MSVC" = 1 ]; then
+        # LARGEADDRESSAWARE lets the 32-bit build address more than 2GB, which
+        # the widest vectors need.
+        executable="./benchmark_$sign.exe"
+        # shellcheck disable=SC2086
+        cl -nologo -std:c++20 -O2 -EHsc -DNDEBUG $EXTRA_CXXFLAGS $INCLUDES \
+            "$source_file" $EXTRA_SOURCES \
+            -Fe:"benchmark_$sign.exe" -link -LARGEADDRESSAWARE $EXTRA_LDFLAGS
+    else
+        executable="./benchmark_$sign"
+        # shellcheck disable=SC2086
+        $COMPILER -std=c++20 -O2 -DNDEBUG $EXTRA_CXXFLAGS $INCLUDES \
+            "$source_file" $EXTRA_SOURCES \
+            -o "benchmark_$sign" $EXTRA_LDFLAGS
+    fi
+
+    echo "==================== benchmark_$sign ===================="
+    "$executable" --elements "$ELEMENTS" --repetitions "$REPETITIONS" --json "$OUT/$sign.json" || true
+
+    if [ ! -s "$OUT/$sign.json" ]; then
+        echo "error: benchmark_$sign did not write $OUT/$sign.json" >&2
+        exit 1
+    fi
+done
+
+echo "==================== data sets ===================="
+ls -l "$OUT"

.github/scripts/setup_benchmarks.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Copyright 2026 Matt Borland
+# Distributed under the Boost Software License, Version 1.0.
+# https://www.boost.org/LICENSE_1_0.txt
+#
+# Clones a Boost tree next to the checkout, drops this library into it, and
+# installs the dependencies the benchmarks need. Exports BOOST_ROOT for the
+# steps that follow. Only used by .github/workflows/benchmarks.yml.
+
+set -e
+
+LIBRARY=${GITHUB_REPOSITORY#*/}
+REF=${GITHUB_BASE_REF:-$GITHUB_REF}
+REF=${REF#refs/heads/}
+
+BOOST_BRANCH=develop
+if [ "$REF" = "master" ]; then
+    BOOST_BRANCH=master
+fi
+
+PYTHON=python3
+if ! command -v python3 > /dev/null 2>&1; then
+    PYTHON=python
+fi
+
+cd ..
+git clone -b "$BOOST_BRANCH" --depth 1 https://github.com/boostorg/boost.git boost-root
+cd boost-root
+mkdir -p "libs/$LIBRARY"
+
+# Everything except doc/: it carries an Antora examples symlink that git-bash on
+# Windows cannot recreate, plus a node_modules tree that nothing here needs.
+for entry in "$GITHUB_WORKSPACE"/*; do
+    if [ "$(basename "$entry")" != doc ]; then
+        cp -r "$entry" "libs/$LIBRARY/"
+    fi
+done
+
+git submodule update --init tools/boostdep
+"$PYTHON" tools/boostdep/depinst/depinst.py --git_args "--jobs ${GIT_FETCH_JOBS:-4}" "$LIBRARY"
+
+echo "BOOST_ROOT=$(pwd)" >> "$GITHUB_ENV"

.github/workflows/amalgamate.yml

@@ -0,0 +1,105 @@
+# Copyright 2025 Matt Borland
+# Distributed under the Boost Software License, Version 1.0.
+# https://www.boost.org/LICENSE_1_0.txt
+#
+# Regenerates the amalgamated single header in extra/single_include/ whenever
+# the real headers change on develop, and commits the result back.
+# The paths filter below does not include extra/single_include/, and the bot
+# commit carries [skip ci], so the push-back cannot retrigger this workflow
+# or the main CI.
+
+name: amalgamate
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - develop
+    paths:
+      - 'include/**'
+      - 'extra/amalgamate.py'
+      - '.github/workflows/amalgamate.yml'
+
+concurrency:
+  group: ${{format('{0}:amalgamate', github.repository)}}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  regenerate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Regenerate the single header
+        run: python3 extra/amalgamate.py
+
+      - name: Smoke test the single header
+        run: |
+          cat > "${RUNNER_TEMP}/smoke.cpp" << 'EOF'
+          // Smoke test for the amalgamated single header. Verifies the header is
+          // self-contained and core operations work end to end.
+
+          #include <boost/int128.hpp>
+          #include <iostream>
+          #include <limits>
+          #include <sstream>
+
+          int main()
+          {
+              using namespace boost::int128;
+              using namespace boost::int128::literals;
+
+              const auto a {BOOST_INT128_UINT128_C(340282366920938463463374607431768211455)};
+              const auto b {18446744073709551615_u128};
+              const auto c {-1234567890123456789_i128};
+
+              if (a / b != 18446744073709551617_u128)
+              {
+                  return 1;
+              }
+
+              if (popcount(a) != 128)
+              {
+                  return 2;
+              }
+
+              if (saturating_add(a, b) != (std::numeric_limits<uint128>::max)())
+              {
+                  return 3;
+              }
+
+              if (c + c != -2469135780246913578_i128)
+              {
+                  return 4;
+              }
+
+              std::ostringstream os {};
+              os << a;
+              if (os.str() != "340282366920938463463374607431768211455")
+              {
+                  return 5;
+              }
+
+              std::cout << "Single header smoke test passed" << std::endl;
+              return 0;
+          }
+          EOF
+          for std in c++14 c++20; do
+            g++ -std=${std} -Wall -Wextra -I extra/single_include "${RUNNER_TEMP}/smoke.cpp" -o "${RUNNER_TEMP}/smoke"
+            "${RUNNER_TEMP}/smoke"
+          done
+
+      - name: Commit and push if changed
+        run: |
+          git add extra/single_include
+          if git diff --cached --quiet; then
+            echo 'Single header is already up to date'
+          else
+            git config user.name 'github-actions[bot]'
+            git config user.email '41898282+github-actions[bot]@users.noreply.github.com'
+            git commit -m "Regenerate amalgamated single header from ${GITHUB_SHA} [skip ci]"
+            git push origin "HEAD:${GITHUB_REF_NAME}"
+          fi