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

(cherry picked from commit 470302017003ab3d831026ae092aeb1fee8ecf5d)

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.

(cherry picked from commit b982306349e5ba3229d1ea9c14ff4ce2efb18233)

fix: Avoid crash for -arch as last compiler option

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

Fixes #1377.

(cherry picked from commit 432e1f5178631aec14a76f8be82c7e090c45bc69)

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

refactor: Move ThreadPool to util

refactor: fs::path-ify util::traverse_directory

refactor: fs::path-ify LockFile

refactor: fs::path-ify LongLivedLockFileManager

refactor: Move Fd to util

refactor: Remove use of mkdir(2)

refactor: Move TemporaryFile to util

ci: Time out jobs after 30 minutes

The default is 360 minutes.

refactor: fs::path-ify some util file functions

refactor: fs::path-ify TemporaryFile

refactor: fs::path-ify core::ensure_dir_exists

test: Fix DirEntry unit tests for Windows mingw64

chore: Fix unit test build after d8b654a30ca8

feat: Rewrite path after -Xclang -include to relative (#1318)

cmake may generate both -include and -include-pch. Example:

c++ ... -Xclang -include-pch -Xclang /abs/path/cmake_pch.hxx.pch
        -Xclang -include -Xclang /abs/path/cmake_pch.hxx ...

Both paths needs to be converted to relative path if CCACHE_BASEDIR is
set for better cache hit rate in some CI systems.

refactor: Remove dependency on core from util

feat: Include maximum size/files in --print-stats

New output:

- max_cache_size_kibibyte: maximum size of local storage in KiB (0 for
  no limit)
- max_files_in_cache: maximum number of files in local storage (0 for no
  limit)

Closes #1315.

refactor: fs::path-ify ignore_header_paths and related functions

bump: Upgrade to fmt 8a4bec5cf53387356738a06ba0cf4fdf086241ae (10.0.0+)

refactor: fs::path-ify is_ccache_executable

refactor: Rename and improve Stat class to util::DirEntry

refactor: Move core/wincompat.hpp to util

refactor: Remove Stat::OnError::throw_error

This is in preparation for moving the Stat class to util where we don't
want to know about core::Error.

refactor: Move Util::traverse to util

refactor: Move Util::send_to_fd to core

chore: Tweak documentation related to debug level

feat: Allow specifying debug level (#1312)

Allow specifying debug level via a debug_level option or CCACHE_DEBUGLEVEL
environment variable.

With debug_level=2 (default), ccache behavior's in debug mode is not changed.

With debug_level=1, ccache will only dump *.ccache-log files (and not the
*input* ones). This is useful for getting per-file caching results.

fix: Work around GCC 12.3 bug 109241

See also #1289.

refactor: Remove superfluous util:: qualifications

bump: Upgrade to xxHash 0.8.2

Closes #1085.

refactor: Improve util::write_fd usage

refactor: Improve util::read_file usage

refactor: Improve util::read_fd usage

enhance: Add util::read_fd variant that returns all data at once

refactor: Switch to tl::expected instead of nonstd::expected