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

refactor: Use util::{throw_on_error,value_or_throw}

fix: Properly signal error on copy failure

Restores behavior before 73a4585a58d5ab818a864485708d706532dfa3b4.

refactor: Move util::rename to util::filesystem

refactor: Move Util::get_hostname to util

refactor: Move Util::get_home_directory to Config

refactor: Move Util::ensure_dir_exists to util

refactor: Move Util::unlink_* to util

refactor: Let util::rename return std::error_code

refactor: Move Util::is_ccache_executable to ccache

chore: Clean up config.h

refactor: Move Util::localtime to util

chore: Improve code style

refactor: Move Util::is_precompiled_header to argprocessing

refactor: Move Util::to_lowercase to util

chore: Add note about using util::rename instead of fs::rename

refactor: Use std::filesystem::current_path

refactor: Improve std::filesystem wrappers

I couldn't figure out how to make the templated versions support both

    path current_path();

and

    void current_path(const path& p);

so using preprocessor macros instead.

refactor: Use std::filesystem::remove_all

chore: Improve util::format_argv_for_logging

refactor: Move Util::format_argv_for_logging to util

refactor: Move Util::get_{actual,apparent}_cwd to util

refactor: Use std::filesystem::create_director{ies,y}

refactor: Move Util::split_into_* to util

refactor: Move Util::size_change_kibibyte to LocalStorage

refactor: Move Util::set_cloexec_flag to util

refactor: Create util::filesystem wrappers returning nonstd::expected

refactor: Move Util::fallocate to util

chore: Fix grammar in comment

refactor: Move UmaskScope to util

refactor: Move Util::{g,s}et_umask to util

refactor: Use fs alias for std::filesystem

fix: Pass error code to fs::temp_directory_path as intended

As noted by Thibault Odorico.

refactor: Move Util::parse_duration to util

refactor: Use std::filesystem::current_path

refactor: Use std::filesystem::canonical

refactor: Use std::filesystem::temp_directory_path

chore: Tweak code style

bump: Upgrade to hiredis 1.2.0

feat: Support multiple -Xarch_* arguments matching -arch (#1131)

refactor: Move Util::rename to util

refactor: Use fs::read_symlink instead of custom implementation

refactor: Get rid of asprintf usage and Windows compatibility wrapper

refactor: Use fs::create_hard_link instead of custom implementation

refactor: Move copy_file to util

refactor: Move clone_hard_link_or_copy_file to local storage class

refactor: Move environment utility functions to util

refactor: Move functions for endian conversion to util

refactor: Move data type conversion utilities to util

refactor: Improve InodeCache::get signature

chore: Remove now unused Hash::HashType distinction

After 561be2085df94b3c35dd803e56668e6feafc93b7 hash debugging will never
be enabled for a Hash instance that hashes binary data, so remove the
now unused Hash::HashType enum and related code.

refactor: Use nonstd::span for data+size in more places

refactor: Use std::array for hash digests instead of custom class

refactor: Improve format_base16/format_base32hex implementations

refactor: Move format_base16/format_base32hex to util

chore: Add missing #include statements

bump: Upgrade to BLAKE3 1.4.1

chore: Tweak code style

feat: Kill Windows compiler subprocess when ccache is aborted (#1274)

feat: Support escaping dollar signs in configuration values

feat: Support environment variables in all configuration items

As mentioned in #1307.

chore: Remove stray -warnings-as-errors entry in .clang-tidy

chore: Improve log message for nonexistent header file for manifest

chore: Make some constructors explicit

feat: Expand environment variables in debug_dir configuration (#1307)

fix: Improve nvcc handling of -Xcompiler and --Werror (#1304)

fix: Improve MSVC .rsp file parsing (#1303)

feat: Let ignore_options/CCACHE_IGNOREOPTIONS also skip option

The ignore_options (CCACHE_IGNOREOPTIONS) configuration makes ccache
exclude matching compiler options from the input hash. This commit also
makes ccache skip matching compiler options from any special processing,
similar to how --ccache-skip works.

As discussed in #1284 and #1301.

chore: Update typos configuration

feat: Don't hash /Fd, /FS or /MP (#1298)

/Fd is to specify the file name of output PDB. But currently ccache only
supports /Z7 which doesn't generate PDB at compile time.

/FS forces writes to PDB to be serialized through MSPDBSRV.EXE.
It shouldn't affect generated files and it has no effect for /Z7.

/MP enables /FS. It creates multiple compiler instances and simultaneously
compile multiple source files which is not supported by ccache.

chore: Fix bad markup in NEWS.adoc

chore: Update authors

chore: Update NEWS

chore: Update .mailmap

bump: Upgrade to cpp-httplib 0.12.6

bump: Upgrade to BLAKE3 1.4.0

refactor: Use std::size to compute array size (#1297)

build: Fix Xcode build of zstd (#1296)

Reproducer (CMake 3.26.4, Xcode 14.3):

    cmake -B _build -GXcode -DCMAKE_OSX_ARCHITECTURES=x86_64 \
          -DZSTD_FROM_INTERNET=ON -DREDIS_STORAGE_BACKEND=OFF
    cmake --build _build

See facebook/zstd#3622

fix: Keep the order of MSVC showIncludes output (#1295)

The bug is introduced in commit 3ec0d4ec961cb0c67ff1603b83a6026d9f3abbb5.

fix: Don't pass -v to the preprocessor

The -v option tells the compiler to print various diagnostics to stdout,
including randomly generated filenames. When ccache calls the
preprocessor and -v is on the command line, the random information will
become part of the input hash, making the preprocessor mode always
produce cache misses.

Fix this by only passing -v when compiling, not preprocessing.

Closes #1293.

Merge pull request #1290 from rkitover/cmake-fixes

chore: Add basic CMakeSettings.json for VS IDE

Add a basic CMakeSettings.json for the Visual Studio IDE using defaults
and Ninja as the generator, for x64, x86 and arm64.

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

fix: Quiet cmake warning for extracted timestamps

For zstd and hiredis downloaded from the Internet, set cmake policy
CMP0135 to NEW to set the timestamps of extracted archive members to the
time of extraction to suppress the cmake dev warning on newer versions
of cmake.

Check that the policy exists so that this works on older versions of
cmake.

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

chore: Re-enable 64 bit msbuild ci jobs

Fixed by 70bf22a5 (fix: Disable masm on msbuild for blake3 with VS,
2023-05-22).

References #1278

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

fix: Disable masm on msbuild for blake3 with VS

Because of some bug with either msbuild or the cmake generator, the C
compiler flags are passed to the masm assembler making it fail.

Use the C intrinsic versions for blake3 when msbuild is in use.

Fix #1278

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