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

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