fix: Don't crash on full disk when recompressing the cache

chore: Make implementation of /Tc and /Tp actually work

In addition to 7b8aaf562feb.

fix: Detect bad remote storage URLs gracefully again

Regression in 829f93c48f21.

Fixes #1394.

feat: Add support for MSVC /Tc and /Tp options

Closes #1387.

bump: Upgrade to fmt 10.2.1

refactor: Simplify Statistics::format_machine_readable slightly

bump: Upgrade to cpp-httplib 0.15.2

fix: Fix MSVC crash when using /Zi /Fddebug.pdb

This commit reverts 8e3ada3f830ad0e7d3ddf4eaf2b16e695bd084e4 (#1274).

Fixes #1386.

feat: Let --inspect retain atime if possible

For storage that relies on atime for LRU cleanup purposes, it makes
sense not to affect atime when inspecting cache entries.

perf: Remove now unnecessary fs::path::string calls

refactor: fs::path-ify core::CacheEntry::Header

perf: Use util::PathString instead of fs::path copy

enhance: Add util::PathString

chore: Remove obsolete section from LICENSE.adoc

chore: Fix some clang-tidy warnings

feat: Add support for MSVC /Yc option (precompiled headers) (#1384)

feat: Add `--print-stats` format selection, JSON format (#1382)

feat: Add `--print-log-stats` (#1381)

This adds a "machine readable" variant of `--show-log-stats`, similar to
`--print-stats` as a variant of `--show-stats`.

chore: Remove left-over debug comment

fix: Disable caching for modified source/include files

On a cache miss, ccache opts out of the direct mode when a "too new"
include file is found. This is done to avoid a race condition in the
direct mode when a header file if modified after ccache is invoked but
before the compiler is executed. Modifying the main source code file is
not a race condition when "run_second_cpp = false", which was the case
at the time the direct mode was introduced. However, the default of
run_second_cpp was changed to true in ccache 3.3, and the potiential
race condition then exists for both the source and the include files.

Fix this by disabling caching completely (not only the direct mode) when
modification of a source/include file is detected.

Closes #1378.

feat: Allow any prefix in prefix_command(_cpp) options

The prefix_command and prefix_command_cpp configuration options require
that the prefixes can be found in PATH.

This commit relaxes this requirement so that a relative prefix can be
used and a prefix program can have arguments.

refactor: fs::path-ify util::is_dev_null_path

enhance: Add Args::push_back(std::string&& arg)

chore: Remove time_of_compilation in favor of time_of_invocation

We can compare source/include files against time of invocation just as
well; source files shouldn't be modified when ccache has started anyway.

refactor: Move Util::is_absolute_path_with_prefix to util

refactor: Use std::string_view in compopt functions

fix: Avoid crash for -arch as last compiler option

The bug has been present since 89aa39f394e0fa4935e6cadd7184e372a37f9506
(ccache 3.3).

Fixes #1377.

refactor: Convert usage of Util::remove_extension to std::filesystem

refactor: Convert usage of Util::dir_name to std::filesystem

enhance: Add wrapper of std::filesystem::equivalent

refactor: Convert usage of Util::change_extension to std::filesystem

refactor: Convert usage of Util::get_extension to std::filesystem

refactor: Convert usage of util::real_path to std::filesystem

test: Add test of core::rewrite_stderr_to_absolute_paths

refactor: Convert usage of Util::base_name to std::filesystem

enhance: Add wrapper of std::filesystem::is_regular_file

refactor: fs::path-ify TestUtil

chore: Update authors

chore: Update NEWS

ci: Add typos job

ci: Bump to codespell 2.2.6

feat: Add support for undocumented GCC/Clang --include option

Note: Clang accepts a concatenated argument (--includefoo.h) but GCC
does not.

Closes #1324.

bump: Upgrade to cpp-httplib 0.14.3

chore: Remove unused local variable

chore: Add debug log when finding -frecord-gcc-switches

build: Set both C/CXX launchers if either is set (#1343)

Add cmake/EnableCcache.cmake and load it from the main file.

Make the standard cmake variables CMAKE_CXX_COMPILER_LAUNCHER and
CMAKE_C_COMPILER_LAUNCHER consistent with each other if either is not
set.

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

feat: Support st_Xtimensec fields in struct stat

This increases file timestamp precision on some BSD-based OSes.

Closes #1369.

fix: Generalize expansion of remote storage URLs with sharding

Fixes #1321.

fix: Correct util::LockFile sleep time constants

Regression in 930d3b67a49f.

refactor: Replace util::is_absolute_path with fs::path::is_absolute

chore: Fix some -Wconversion warnings

fix: Handle -Xclang -ast-dump et al correctly

Fixes #1356.

feat: Improve processing of input file arguments

Instead of checking if a non-option argument has a known file extension,
switch to the better heuristic of checking if the file exists or not: if
it doesn't exist it isn't an input argument.

fix: Use MSVC logic for clang-cl when handling precompiled header (#1365)

chore: Improve typos configuration (#1358)

ci: Remove matrix.config from build.yaml (#1360)

ci: Split dependency installation step into two (#1359)

test: Fix regex in direct.bash (#1357)

fix: Detect compiler from unresolved symlink with fallback

This is a generalization of the fix in PR #1348 for issue #1347.

chore: Remove obsolete Util::is_dir_separator

chore: Remove superfluous #includes

fix: Detect symlink called clang-cl as clang-cl (#1348)

Fixes #1347.

feat: Add support for clang --analyze (#1345)

fix: Devmode unused function warnings on new MSVC (#1342)

MSVC apparently has overrides for the two definitions of operator== in
unittest/test_util_string.cpp in the <utility> header, raising a warning
about them being local unused functions:

https://learn.microsoft.com/en-us/cpp/error-messages/compiler-warnings/compiler-warning-level-4-c4505?view=msvc-170

Disable this warning type in cmake/DevModeWarnings.cmake for MSVC.

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

feat: cmake -DOFFLINE=TRUE for offline builds (#1341)

Add the cmake option OFFLINE, defaulting to the value of the standard
variable FETCHCONTENT_FULLY_DISCONNECTED, which is OFF by default, to
disable downloading anything from the internet.

When ON, set FETCHCONTENT_FULLY_DISCONNECTED to ON, ZSTD_FROM_INTERNET
to OFF and HIREDIS_FROM_INTERNET to OFF.

When downloading is OFF and either library is not found, throw an error
using find_package_handle_standard_args().

Add the option to INSTALL.md doc.

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

fix: cmake -DSTATIC_LINK=ON on Linux/macOS (#1340)

Make linking dependent libraries as static a hard requirement when
STATIC_LINK is ON, as opposed to the previous behavior of falling back
to dynamic libraries.

A side-effect of this is that if only a dynamic zstd/hiredis is
available on a system, it will not be found, and the download and build
code will be invoked to build a static version from the internet.

Add a general case to handle Linux, macOS and similar by linking
libgcc/libstdc++ statically on gcc/clang.

Move the code into cmake/StaticLinkSupport.cmake and include it from the
main file.

Fix #1330

Signed-off-by: Rafael Kitover <rkitover@gmail.com>

fix: Mark -wrapper as too hard

See also #1339.

docs: Improve language

refactor: Use fs::weakly_canonical in prepare_debug_path

fix: Make handling of Clang config options more robust

Closes #1335.

fix: Fix Windows is_absolute_path() crash on drive letter (#1338)

fix: Fix sign-compare warning src/InodeCache.cpp on FreeBSD (#1331)

As on FreeBSD 13.2 statfs.f_bavail is signed, InodeCache.cpp cannot be compiled
but gets a sign-compare warning:

  src/InodeCache.cpp:409:30: error: comparison of integers of different signs:
    'long' and 'unsigned long' [-Werror,-Wsign-compare]
      if (buf.f_bavail * 512 < k_min_fs_mib_left * 1024 * 1024) {
          ~~~~~~~~~~~~~~~~~~ ^ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1 error generated.

The problem is avoided by using static_cast to uint64_t.

fix: Let DirEntry::size_on_disk return likely size on disk

st_blocks in struct stat cannot be trusted for some filesystems that do
transparent compression or deduplication. For instance, ZFS can adjust
the block count some time in the future when compression is finished.

The only reasonable fix for this seems to be to just guess how much
space the file will take using st_size.

Fixes #1332.

fix: Bail out on too hard options -fmodules-ts and -fmodule-header

Fixes #1333.

chore: Add entries to codespell allow list

refactor: Move Logging to util

refactor: Move Win32Util::error_message to util

refactor: Move Win32Util::argv_to_string to util

refactor: Move Win32Util::add_exe_suffix to util

refactor: Move Win32Util::get_last_ntstatus to util::DirEntry

util::DirEntry is the sole user of Win32Util::get_last_ntstatus.

refactor: Move File to util::FileStream

refactor: Move NonCopyable to util

refactor: Move fmtmacros to util

refactor: Move Finalizer to util

refactor: Move assertions to util

bump: Upgrade to BLAKE3 1.5.0

chore: Prepare for version 4.8.3

(cherry picked from commit 044558e647b49dbc8fc89b810a7d22f526101e6b)

bump: Upgrade to fmt 10.1.1

fix: Exit more gracefully on invalid sharded remote storage URL

As mentioned in #1321.

chore: Avoid linting suppression for Storage::~Storage

bump: Upgrade to cpp-httplib 0.14.0

docs: Mention that system_headers sloppiness is not supported for MSVC

Closes #1224.

fix: Fix bookkeeping of raw files

Ccache 4.8-4.8.2 notes the size and count of raw files (written to the
cache if hard link or file clone mode is enabled) to a level 2 stats
file. However, the new cleanup algorithm (also introduced in 4.8)
assumes that all size/count statistics are placed in a level 1 stats
file. After a "ccache -c", the raw files will be "rediscovered" and
noted in level 1 stats files, thus duplicating bookkeeping in level 2
stats files, resulting in a too high cache size figure in "ccache -s".

To fix this, ccache will now:

- Note size/count of raw files in the proper level 1 stats file.
- When storing an entry on a cache miss, detect if the corresponding
  level 2 stats file has non-zero size/count statistics and propagate
  them to the level 1 stats file if so.
- Zero out files/count statistics for level 2 stats file on "ccache -c".

This means that the reported cache size will gradually correct itself
automatically. Alternatively, the user can run "ccache -c" to fix all
counters immediately.

Fixes #1320.

enhance: Support updating stats file only if values have changed

refactor: Improve name of LocalStorage::increment_level_2_counters

refactor: Use LocalStorage::get_stats_file

chore: Fix grammar in comments

chore: Avoid ccache:disable strings in ccache source code

A verbatim ccache:disable string disables ccache when compiling some
ccache sources, which is unnecessary.

bump: Upgrade to fmt 10.1.0

refactor: Move AtomicFile to core