chore: Modernize Python code in test/http-*

test: Fix detection of test suites in test/run

Broke in 9da7c09c9390b2db5c745a8dad58d7a3ac3af9b0.

fix: Redact URLs logged by remote http backend

docs: Mention that #pragma once could be problematic with PCH

Fixes #1615.

refactor: Improve name and type of only_if_missing parameter

Merge pull request #1598 from mstorsjo/ci-arm

ci: Add jobs for building binaries for Windows and Linux

Build binaries for x86_64 and aarch64 on Linux, and i686, x86_64
and aarch64 for Windows.

The Windows binaries are cross compiled from Linux. For x86, it
uses distro provided compilers, while it uses llvm-mingw installed
separately for targeting aarch64. (Most distros don't have packages
for mingw cross compilers for targeting Windows on aarch64 yet. GCC
isn't mature for this target yet, but Clang has supported this
target for many years now. Llvm-mingw is essentially the same toolchain
setup as MSYS2 uses in their clangarm64 environment, but available
as a standalone cross compiler too.)

ci: Add a toolchain file for (cross) compilation for aarch64-w64-mingw32

Contrary to the existing toolchain files, this doesn't hardcode
CMAKE_FIND_ROOT_PATH to a location in /usr, but locates the
compiler from the path, and picks a sysroot adjacent to it - allowing
using a compiler installed in any path.

This uses a compiler named "${TOOLCHAIN_PREFIX}-gcc" - toolchains
such as llvm-mingw do provide cross tools named "-gcc" for
compatibility, even if they use Clang.

ci: Run build_and_test on Linux on ARM too

ci: Run the Windows VS2022 ARM64 MSBuild tests on actual ARM hardware

ci: Extend the msys2 testing to the "clangarm64" environment

The clangarm64 msys environment doesn't have a "gcc" command
by default, unless the "gcc-compat" package is installed.

One may consider using "cc" as well, which is available when
the "toolchain" package is installed in each environment, but
that tool in clang environments fails the "direct" test case.

ci: Use pacboy to simplify installation of msys2 packages

See [1] and [2] for reference on using pacboy to simplify installing
mingw packages in msys2. The relevant bit to know is that by
specifying plain package names with a ":p" suffix, in the "pacboy"
section in msys2/setup-msys2, those packages are installed within
the current msys2 environment.

This avoids needing to specify the long package prefix like
"mingw-w64-x86_64". For other environments like "ucrt64", "clang64"
and "clangarm64", the prefix is even longer and less obvious.

[1] https://github.com/msys2/setup-msys2?tab=readme-ov-file#pacboy
[2] https://www.msys2.org/docs/package-naming/#avoiding-writing-long-package-names

ci: Stop manually installing Ninja on Linux and macOS

Since https://github.com/actions/runner-images/pull/11706,
https://github.com/actions/runner-images/pull/11707 and
https://github.com/actions/runner-images/pull/11737, ninja is
preinstalled in the Ubuntu, macOS and x86 Windows runner images.

refactor: Use TRY_ASSIGN and TRY

fix: Properly make unique temporary name in TRY_ASSIGN

refactor: Extract macros for creating unique variable names

ci: Declare downloaded zstd as EXCLUDE_FROM_ALL

8648532e3cdcd6a0c4fb12b65e1ca9a8972a1e06 removed usage of
FetchContent_Populate to avoid warnings from newer CMake versions, but
the EXCLUDE_FROM_ALL part got lost in translation.

Corresponding semantics is available by passing EXCLUDE_FROM_ALL to
FetchContent_Declare, but only since CMake 3.28 so we need to add some
backward compatibility goo.

build: Remove obsolete variable in FindZstd.cmake

chore: Make code buildable with tl-expected 1.2.0

tl-expected 1.2.0 has made tl::expected objects [[nodiscard]], so make
sure to handle all tl::expected return values properly.

bump: Upgrade to tl-expected 1.2.0

enhance: Add TRY_ASSIGN macro

enhance: Improve TRY macro

refactor: Simplify EINTR check for waitpid

feat: Don't log failure when removing output file in hard link mode

If there is no preexisting output object file then we shouldn't indicate
an error.

refactor: Rename local variable in macro to avoid clashes

chore: Remove redundant logging of error

ci: Avoid using windows-latest runner image

fix: Expand system-dependent -m{arch,cpu,tune}=native options

The -march=native, -mcpu=native and -mtune=native options have different
effects depending on which system the compiler is run.

Fix this by asking the compiler which cc1 options the -m*=native options
expand to and including them in the input hash.

Fixes #824.

refactor: Extract command execution code from hashutil to util function

feat: Improve logging in execute* functions

chore: Simplify Windows-specific hacks for shell scripts in test suite

refactor: Improve variable name in win32execute

chore: Remove dead code in hash_command_output

refactor: Move Args to util namespace

enhance: Add Args initializer list constructor

chore: Add build-ccache-with-itself script

This script can be used to verify that ccache is able to cache a build
of itself.

Example usage:

    COMMAND=/source/misc/build-ccache-with-itself misc/build-in-docker debian-12

chore: Finalize renaming of namespaces to lowercase

fix: Keep original order of compiler arguments

Now when CCACHE_NOCPP2 (run_second_cpp = false) has been removed (see
fd9de83446aeaf1eb1b33a2d900ea1ff757c4509) we can simplify compiler
argument juggling: instead of partitioning arguments into different
lists and reassemble them later, we can build up the preprocessor and
compiler command lines while we go, thus keeping the original order of
arguments.

Fixes #738.

chore: Remove ability to avoid 2nd call to preprocessor (run_second_cpp)

ccache before version 1.6 (2002) always sent precompiled source to the
compiler as an optimization to avoid running the preprocessor a second
time. ccache 1.6 (2002) introduced CCACHE_CPP2 to optionally disable
this optimization. This seemed to work well until mid 2010s when
compilers started to behave differently when compiling preprocessed and
non-preprocessed source code. Thus, ccache 3.3 (2016) flipped the
default to make the optimization opt-in via CCACHE_NOCPP2 (or
"run_second_cpp = false").

Fast forward to 2025:

- As far as I can tell, CCACHE_NOCPP2 is used by essentially nobody
  which isn't surprising since it generally doesn't work well.
- The feature comes with increased code complexity. The most painful
  part is that compiler arguments need to be carefully filtered and sent
  to only the preprocessor, only the compiler or both, depending on
  whether run_second_cpp is true or false. And it can be forced to true
  in the middle of argument parsing when an argument that is
  incompatible with "run_second_cpp = false" is found.
- There have been a non-trivial amount of bugs related to CCACHE_NOCPP2
  during the years due to the added complexity and due to new compiler
  behavior that is incompatible with the mode.a
- The depend mode is a more performant alternative to "run_second_cpp =
  false" since ccache 3.6 (2019), though with different tradeoffs.

Thus it's time to make the code less complex and more maintainable:
remove the optimization to send the precompiled source code to the
compiler.

This opens up making argument juggling simpler and fixing bug #738.

chore: Improve code style

chore: Bump to Clang-Format 18

docs: Mention mitigation for direct mode caveat

fix: Fix bug in support for Clang to compile CUDA code on Windows

chore: Remove ubuntu-20.04 Dockerfile as its CMake is too old

build: Drop minimum CMake version to 3.18

This is to keep supporting Debian 11 for a while longer.

Note that 8648532e3cdcd6a0c4fb12b65e1ca9a8972a1e06 requires CMake > 3.16
(not sure whether 3.17 works), so dropping back to 3.15 is not possible.

Closes #1611.

fix: Include MSVC variables INCLUDE and EXTERNAL_INCLUDE in input hash

See discussion #1606.

ci: Small GH actions cleanup (#1602)

Remove superfluous ${{ }}.

Link libatomic statically when STATIC_LINK is set (#1601)

Link libatomic statically when STATIC_LINK is set.

build: Avoid warning from downloaded zstd's CMake scripts

build: Use FetchContent_MakeAvailable instead of FetchContent_Populate

Closes #1501.

build: Require CMake 3.22 or newer

For reference, CMake 3.22 is available in Debian 11 as well as Ubuntu
22.04. Distributions based on RHEL 8 have 3.25 or later.

feat: Embed manifest to enable long paths on Windows (#1596)

On a windows build, add a ccache.exe manifest which enables long path awareness in Windows 10+.

Fixes #1595.

test: Add test for tricky preprocessed cache hit case

See PR #1594.

feat: Improve logging for manifest lookup

build: Use bundled fmt if DEPS=DOWNLOAD as documented

feat: Log URLs requested by http backend

fix: Detect cc/c++ hard link to clang/clang++ before gcc/g++

Apparently clang/clang++ can be gcc/g++ in addition to cc/c++, at least
on some macOS versions, so detect clang hard link before gcc since the
other way around (gcc installed as an alias of clang) seems less likely.

Fixes #1597.

ci: Remove jobs for soon to be removed windows-2019 runner

chore: Tweak Clang CUDA code slightly

chore: Fix source file headers

chore: Clean up and modernize dockerfiles

feat: Support -x cu and -x cuda in Clang CUDA mode (#1593)

ci: Use CodeQL v3 (#1592)

This workflow throws an deprecation warning right now:

CodeQL Action major versions v1 and v2 have been deprecated. Please update all occurrences of the CodeQL Action in your workflow files to v3. For more information, see https://github.blog/changelog/2025-01-10-code-scanning-codeql-action-v2-is-now-deprecated/

feat: Add support for Clang compiling CUDA code (#1577)

chore: Update NEWS

(cherry picked from commit a50f01935030e46fd6f35184ba7b1f11105967b7)

ci: Disable testing for Windows MSYS2 mingw64 clang

Clang warns about doctest's include of ciso646:

    In file included from D:/a/ccache/ccache/unittest/main.cpp:26:
    In file included from D:/a/ccache/ccache/build/_deps/doctest-src/doctest/doctest.h:499:
    D:/a/_temp/msys64/mingw64/include/c++/15.1.0/ciso646:46:4: error: "<ciso646> is deprecated in C++17, use <version> to detect implementation-specific macros" [-Werror,-W#warnings]

       46 | #  warning "<ciso646> is deprecated in C++17, use <version> to detect implementation-specific macros"

          |    ^

    1 error generated.

See also doctest issue 900.

build: Adapt to doctest 2.4.12

Apparently doctest 2.4.12 has introduced some backward incompatibility
that affects our unit tests, so adapt accordingly.

Fixes #1589.

fix: Don't swallow -Xpreprocessor -fopenmp

This fixes regression in bea737780727e751a8193fc80c83c7c072b8048e

Fixes #1586.

bump: Upgrade to hiredis 1.3.0

bump: Upgrade to BLAKE3 1.8.2

chore: Split util::split_once into util::split_once{,_to_views}

The util::split_once(std::string&&, char) version is a bit overly smart
in that it returns std::string instead of std::string_view for a
temporary std::string input. To reduce the risk for surprises, introduce
a util::split_once_into_views so that input lifetime is indicated in the
method name instead.

chore: Clean up profiling_gcc_10+ test suite

test: Silence benign compiler warning in the profiling_gcc_10+ suite

chore: Fix some Clang-Tidy warnings

chore: Build with -Wextra-semi/-Wextra-semi-stmt and fix issues

feat: Log which result entry matched in manifest

chore: Log usage of cmd_args temporary file earlier

feat: Improve logging of process exit

feat: Log mtime for removed files in internal tempdir

refactor: Extract timestamp format to util::format_iso8601_timestamp

chore: Update NEWS

(cherry picked from commit ddb73f16079a41b93ec7e65cb6769f9b5f7d3f68)

chore: Update NEWS

(cherry picked from commit 45018e4ecf606e1e0c83446fdc0c8516fda58958)

fix: Reset signal mask and defaults when executing compiler

Fixes regression in 1eb0aa5b9bcf74bd2ca6f161e406da64ccd349af where
posix_spawn was introduced to replace fork.

Fixes #1580.

bump: Upgrade to cpp-httplib 0.20.0

chore: Update NEWS

(cherry picked from commit e05fab8e734c76e70d821ca7036e73a25dd564cf)

fix: Fix log file locking on Windows

Fixes #1575.

chore: Prepare for release

chore: Update authors

chore: Update NEWS

test: Remove centos-7 Dockerfile

test: Add alma-8 Dockerfile

feat: Add knowledge about options related to react-native builds (#1567)

- Add compopt entries for -ivfsoverlay, -fmodules-cache-path, -fmodule-map-file and -fbuild-session-file
- Add hashing of build session file mtime unless sloppiness flag is set
- Add unit tests for the flags above as well as an e2e test for -fbuild-session-file

test: Add debian-12 to test-all-systems

test: Refresh dockerfiles and add Debian 12 (#1538)

- Make gcc package name configurable, this is to fix
  "E: Package 'gcc-multilib' has no installation candidate"
  on non-x86.

- Allow BASE_IMAGE to be overridden.

- Add Debian 12.

refactor: Remove redundant args_info parameter from hash_common_info

docs: Add space after CMake -D option

bump: Upgrade to xxhash 1.5.7

bump: Upgrade to xxhash 0.8.3

bump: Upgrade to fmt 11.1.4

bump: Upgrade to blake3 1.6.1