chore: Fix copyright row order

refactor: Introduce and use DEFER macro, replacing util::Finalizer

refactor: Introduce and use CHECK_LIB_CALL macro

build: Fix detection of Fmt version for Fmt<11

Fixes regression in 71f772e9d3d4f8045cfa7bccd03bd21c1e8fbef1.

build: Try harder to determine FMT_VERSION (#1478)

fmt-11.0 moved the FMT_VERSION from core.h to base.h, so try the
new header first and then fall back to the old one.

Closes: #1477

chore: Update authors

(cherry picked from commit 4c6181f7f93f8dad8106973aaf55475cddfd2730)

chore: Update NEWS

(cherry picked from commit 14a0714cbfe2b1e5eaebf50c8fef17529a60a01b)

chore: Fix reference to format.cc in LICENSE.adoc

refactor: Convert some std::string paths to fs::path

chore: Rename source files to lowercase for consistency

refactor: Clean up some fs::path usage

refactor: Convert Config::m_temporary_dir to fs::path

refactor: Convert Config::m_stats_log to fs::path

refactor: Convert Config::m_log_file to fs::path

refactor: Convert Config::m_cache_dir to fs::path

refactor: Convert Context::i_tmpfile to fs::path

refactor: Use fs::path for Context::register_pending_tmp_file

refactor: Improve handling of ignore_header_paths matching

refactor: Convert ArgsInfo::sanitize_blacklists to fs::path

refactor: Convert ArgsInfo::profile_path to fs::path

refactor: Convert ArgsInfo::included_pch_file to fs::path

chore: Add ubuntu-24.04 Dockerfile

refactor: Convert ArgsInfo::orig_included_pch_file to fs::path

refactor: Convert ArgsInfo::output_al to fs::path

refactor: Convert ArgsInfo::output_ipa to fs::path

refactor: Convert ArgsInfo::output_dwo to fs::path

refactor: Convert ArgsInfo::output_dia to fs::path

refactor: Convert ArgsInfo::output_ci to fs::path

refactor: Convert ArgsInfo::output_su to fs::path

refactor: Convert ArgsInfo::output_dep to fs::path

refactor: Convert ArgsInfo::output_obj to fs::path

refactor: Convert APIs to use std::filesystem::path for paths

enhance: Add Args::push_back(const std::filesystem::path&)

refactor: Convert ArgsInfo::orig_output_obj to fs::path

refactor: Convert ArgsInfo::input_file to fs::path

refactor: Improve language_for_file signature

refactor: Convert ArgsInfo::orig_input_file to fs::path

refactor: Use util::with_extension

enhance: Add util::with_extension

enhance: Add util::add_extension

refactor: Add and use util::pstr type alias

Also removed less common util::PathString::operator const char* to make
some call sites unambiguous.

refactor: Convert APIs to use std::filesystem::path for paths

chore: Add note about --compile being an NVCC option

feat: Support NVCC --compile option (#1475)

The nvcc (CUDA) compiler has a extra option compliant with -c: --compile.
https://docs.nvidia.com/cuda/cuda-compiler-driver-nvcc/#supported-phases

So ccache should see the --compile option as the -c option (especially because the CUDA MVS plugin use it!)

perf: Use posix_spawn to execute the compiler (#1471)

build: Simplify cxxurl build script

build: Remove no longer needed workaround when building downloaded Zstd

build: Bundle Fmt again

Fmt is currently the only required C++ dependency that isn't bundled.
Since the Fmt API is still evolving, it's convenient for Ccache users
that lack a proper Fmt version locally to be able to build without
having to download Fmt. Thus, bundle Fmt again for now. (When we can
bump compiler requirements to versions that implement std::format
properly in the future we will switch to std::format instead.)

Closes #1470.

test: Improve CCACHE_PREFIX test to catch regression fixed in PR #1474

docs: Clarify that --set-config writes to the configuration file

See also discussion #1468.

build: Search for libcpp-httplib before libhttplib

The cpp-httplib project has now standardized on libcpp-httplib.so for
the shared library, so search for that name first.

fix: Fix prefix command lookup from PATH (#1474)

This fixes regression in 6b85822b50cc509b4d595bf89340bdf0da526dc9.

build: Find CppHttplib named libhttplib.so as well (#1465)

On Gentoo, the library name is 'httplib', not 'cpp-httplib'. Search
for that first (as it appears to be "more vanilla"), then fall back
to 'cpp-httplib'.

chore: Fix blake3.h pattern in .clang-format after 2950646b473e

chore: Include fedora-40 in test-all-systems and remove duplicates

build: Fix detection and usage of system blake3 (#1464)

chore: Remove Xcode assembly workaround for zstd (#1463)

The fix is included in upstream zstd 1.5.6.

chore: Update authors

chore: Update NEWS

ci: Disable Ubuntu 24.04 builds temporarily

Logs end like this:

    Running kernel seems to be up-to-date.

    Restarting services...
     systemctl restart chrony.service containerd.service cron.service fwupd.service haveged.service hv-kvp-daemon.service multipathd.service packagekit.service php8.3-fpm.service polkit.service redis-server.service rsyslog.service runner-provisioner.service systemd-journald.service systemd-networkd.service systemd-resolved.service systemd-udevd.service udisks2.service walinuxagent.service
    Error: The operation was canceled.

build: Fix zstd build for older CMake versions

With CMake 3.17.5 on CentOS7:

    -- Downloading Zstd from the internet since Zstd>=1.3.4 was not found locally and DEPS=AUTO
    CMake Error at cmake/FindZstd.cmake:60 (set_target_properties):
      set_target_properties Can not find target to add properties to:
      libzstd_static
    Call Stack (most recent call first):
      cmake/Dependencies.cmake:29 (find_package)
      CMakeLists.txt:88 (include)

    CMake Error at cmake/FindZstd.cmake:68 (add_library):
      add_library cannot create ALIAS target "dep_zstd" because target
      "libzstd_static" does not already exist.
    Call Stack (most recent call first):
      cmake/Dependencies.cmake:29 (find_package)
      CMakeLists.txt:88 (include)

chore: Juggle some include headers

build: Fix MSVC /Zc:preprocessor warning (#1461)

Don't add the /Zc:preprocessor- compiler flag when it's not needed, to
avoid the following warning:
D9025 : overriding '/Zc:preprocessor' with '/Zc:preprocessor-

The latest Windows SDK v10.0.22621 compiles fine with conforming
preprocessor enabled, the bug was in older SDK-s like <=10.0.20348.0.

Add the /Zc:preprocessor for msvc >=v19.25, it didn't exist before this
version (it existed as /experimental:preprocessor before).

chore: Remove unused headers (#1460)

refactor: Use tl::expected for process_args return value

This should make the error paths more obvious.

As discussed in #1459.

chore: Fix some Cppcheck warnings

chore: Remove obsolete os_path helper in test_storage_local_util

chore: Improve cast and avoid repeating types (#1459)

feat: Add argument handling for Emscripten's --em-config (#1458)

build: Fix setting of DEPS=LOCAL if FETCHCONTENT_FULLY_DISCONNECTED=ON

Fixes #1456.

chore: Fix spelling

perf: Use posix_spawn for executing compiler check command (#1451)

refactor: Simplify code

ci: Add GCC 14 build

ci: Use ubuntu-24.04 for GCC 13

Apparently the ubuntu-22.04 image no longer has the g++-13-multilib
package, at least not in GitHub.

feat: Add --print-version option (#1454)

I have added a new `--print-version` option as ccache will support PCH
on msvc and I will need to somehow detect the ccache version to
correctly decide if PCH should be disabled
(`CMAKE_DISABLE_PRECOMPILE_HEADERS`).

So if ccache >=4.10 then don't disable PCH and if it's below then set
`CMAKE_DISABLE_PRECOMPILE_HEADERS=ON`.

fix: Remove TAKES_ARG for /Fp and /Yu MSVC options (#1453)

/Fp and /Yu don't allow space between option and option value.

Fixes #1452

fix: Handle -Yc without -Fp and -Fo for msvc (#1450)

It allows passing the `-Yc` option without the `-Fp` option and also
without the `-Fo` option.

fix: Handle -Yc without filepath for msvc (#1448)

This PR further fixes the #1384. Fixes the case when the `/Yc` option is
without the filepath and the `/Fppathname` is also defined.

The `/Yc` can be passed in two ways with and w/o the filepath. When it's
passed w/o the filepath it must take the value of the `/Fp` option and
if the `/Fp` option isn't defined then the resulting .pch file must have
the same base name as the base source file with appended `.pch`
extension (this case isn't handled correctly by ccache).

The `/Yc` option doesn't support passing a filepath with the space
between like `/Yc filepath`. Because of this the `TAKES_ARG` must be
removed. All occurrences of `compopt_takes_path()` can't be invoked for

I have also added a new unittest for this case: "MSVC PCH options with
empty -Yc" and also tested it manually on my example project. Just now,
I have also tested it on a big project with 200 TU with qmake and cmake
build systems with msvc and also clang-cl with msvc compilers with 100%
cache hits (PCH enabled and /Zi replaced with /Z7).

feat: Add support for -fdump-ipa-clones (#1449)

Fixes #1447. Citing:

`-fdump-ipa-clones` is used heavily for live patching. Especially, when
one builds a distro kernel (like SLE 15 SP6), the build uses the option
to generate additional `.000i.ipa-clones` files.

fix: Force run_second_cpp=true when generating profiling information

If run_second_cpp=false the coverage report will refer to the temporary
preprocessed file instead of the source file. Fix this by forcing
run_second_cpp=true if profiling information is being generated.

Fixes #1441.

fix: Hash "apparent real path" of object file when using -fprofile-arcs

The object file stores an absolute path based on apparent CWD when
-fprofile-arcs is used, not only the relative object filename.

test: Improve verbose printing of test names

refactor: Add more Hash::hash overloads

docs: Improve documentation of gcno_cwd sloppiness

As suggested by Ben Portner in #1444.

fix: Handle -fdiagnostics-color for Clang again

Regression in 96ec6c9d98b88f00e1a69bdd0214c237bc7ed04e (ccache 4.6.2).

Fixes #1446.

chore: Clean up comment and debug log string

test: Improve printing of test suite

chore: Fix typo

chore: Add Andrew Stubbs to typos ignore list

chore: Remove unnecessary depend_extra_args

The ordinary compiler_args list can be used for executing the compiler
in the depend mode since dependency arguments are present there after
07b55f13e119a2a35d166a73929643911ea69d52.

test: Improve verbose printing of test names

feat: Support -Xpreprocessor -fopenmp in direct mode

All uses of -Xpreprocessor disable the direct mode as a safety measure
since the command line could include things like

  -Xpreprocessor -MF -Xpreprocessor file.d

which ccache needs to understand as

  -MF file.d

Ideally, ccache should handle this in a generic way. Meanwhile, let's
allow it in the a special case of "-Xpreprocessor -fopenmp" since that's
required on macOS to enable OpenMP.

Closes #1434.

refactor: fs::path-ify some functions

Fixes #1417.

bump: Update to nonstd-span 0.11.0

bump: Update to zstd 1.5.6

refactor: Improve util::copy_file implementation

- Merge macOS and POSIX implementations into one.
- Improve error messages.
- Improve variable names.

refactor: Improve dependency file parsing

- Use Depfile::tokenize to parse the dep file in rewrite_source_paths
  instead of an even more ad-hoc parser.
- Add Depfile::untokenize to go from tokens back to text representation.

ci: Improve MSYS2 job names

build: Improve handling of dependencies (#1429)

- Introduced a new CMake variable called `DEPS` with the following
semantics:
- `AUTO` (the default): Use dependencies from the local system if
available. Otherwise: Use bundled dependencies if available. Otherwise:
Download dependencies from the internet (dependencies will then be
linked statically).
- `DOWNLOAD`: Use bundled dependencies if available. Otherwise: Download
recommended versions from the internet (dependencies will then be linked
statically).
- `LOCAL`: Use dependencies from the local system if available.
Otherwise: Use bundled dependencies if available.

The old `HIREDIS_FROM_INTERNET`, `ZSTD_FROM_INTERNET` and `OFFLINE`
variables have been removed in favor of `DEPS`.
- Streamlined the CMake code for hiredis and zstd.
- Removed bundled `getopt_long` implementation.

It seems likely that getopt_long is available on all platforms where
ccache is built nowadays, except Windows. Therefore, remove the bundled
getopt_long implementation for now.

If it turns out that somebody wants to compile ccache on a system that
lacks getopt_long we can add support specifying a system or downloaded
version.
- Implemented our own AVX2 runtime detection instead of using a blake3's
ditto. This opens up for using blake3 from the system.
- Added support for using blake3, httplib, nonstd/span and tl/expected
from the system instead of bundled versions.
- Removed bundled doctest, fmt and xxhash dependencies. Instead,
download them if missing.

Closes #1396.
Closes #1424.