fix: Avoid hashing CWD parts of -march=native expansion for Clang

Fixes #1658.

fix: Look for correct -march=native expansion line on Windows

ci: Remove some less important CI jobs

Testing large parts of the test matrix is valuable. But at the same
time, lots of CI jobs consume lots of resources. Let's find a better
balance.

test: Fix directory check for Windows paths

msys2 jobs have for some strange reason started to fail, so msys2's pwd
must have started returning full pathname including ":" on Windows.

enhance: Improve find_executable

refactor: Rename k_redacted_password to k_redacted_secret

enhance: Add util::Timer::reset method

refactor: Add missing util namespace to Timer

chore: Add alma-10 dockerfile

test: Support valkey in remote_redis test suite

chore: Update authors

(cherry picked from commit 8c107aada09df2a40930d7064bbec8120ee76c91)

chore: Update NEWS

(cherry picked from commit 0962c414c87aec5d7903349fa9faabec45919637)

ci: Fix paths to release binaries

ci: Remove obsolete macOS-13 build

ci: Fix prefix for Linux binary release build

feat: Improve compiler check on macOS

On macOS, the /usr/bin/clang(++) executables are shims that redirect to
different compilers based on $DEVELOPER_DIR or xcode-select
configuration, so ccache's default compiler check (hash mtime+size) is
done on those shims instead of the real compilers.

Improve this by trying to look up the real compiler via $DEVELOPER_DIR
or xcode-select configuration when hashing compiler data.

Closes #1654.

feat(msvc): Use /sourceDependencies to extract include file paths

Extract include file paths from MSVC's /sourceDependencies output
instead of parsing preprocessed output. This eliminates the need for the
/utf-8 flag and msvc_utf8 config option, allowing ccache to work
correctly with both Unicode and "ANSI" (non-Unicode) codebases without
user configuration.

This resolves the encoding issues described in issues #1619 and #1650 by
using a more robust approach that doesn't depend on source file
encoding.

The change applies to both preprocessor mode and depend mode. For MSVC
versions older than 2017 15.7 that don't support /sourceDependencies,
ccache falls back to parsing preprocessed output. Other MSVC-like
compilers (clang-cl, nvcc, etc.) continue using /showIncludes.

refactor: Move clang/msvc code to src/ccache/compiler

enhance: Add util::SimpleJsonParser

feat(msvc): Add support for caching /sourceDependencies file

chore: Remove obsolete generating_debuginfo_level_3 variable

Obsolete as of fd9de834 "chore: Remove ability to avoid 2nd call to
preprocessor (run_second_cpp)".

test: Add basic MSVC integration test suite

We need some basic MSVC integration/smoke tests. Since I think it's a
dead end to try to adapt the bash-based test suite for MSVC, this commit
adds a separate Python-based test suite instead. It's not a full
solution but rather something quick to cover the most basic testing
needs.

refactor: Remove unnecessary cleanup of args after executing compiler

refactor: Improve Bytes::{erase,insert} signatures

chore: Improve comments

refactor: Simplify handling of --serialize-diagnostics

test: Add test for --serialize-diagnostics

docs: Fix typos in news

fix: Be robust against filesystem path encoding problems on Windows

perf: Parallelize -X/--recompress

enhance: Make ProgressBar thread safe

perf: Parallelize -x/--show-compression

feat: Merge --{recompress,trim-recompress}-threads into --threads

Bonus: Cleaned up handling of old options kept for backward
compatibility.

enhance: Add util::ThreadPool::enqueue, returning a std::future

test: Add unit tests for util::ThreadPool

feat: Support enqueuing ThreadPool tasks from worker threads

refactor: Improve ThreadPool variable names

chore: Make ThreadPool non-copyable

perf: Add fast path in ThreadPool::enqueue

perf: Move function into ThreadPool task queue

fix: Start at least one thread in ThreadPool

refactor: Use std::chrono_literals

enhance: Add util::format_duration

enhance: Support h/m/ms suffixes for durations as well

refactor: Extract duplicated PCH check code to a helper function

chore: Improve comments

build(blake3): Assume aarch64 to be little-endian on CMake 3.18/3.19 (#1652)

The recently introduced detection of big-endian AArch64 uses the
CMAKE_C_BYTE_ORDER variable, which was introduced in 3.20, but ccache
currently only requires CMake 3.18.

To avoid using an undefined variable, simply assume AArch64 to be
little-endian on CMake versions that don't define the aforementioned
variable. This is okay because big-endian AArch64 has few users and the
subset of them that use CMake 3.18/3.19 is likely negligible.

Reported-by: @awawa-dev
Fixes: https://github.com/ccache/ccache/issues/1651

feat: Add msvc_utf8 config option to allow disabling /utf-8 for MSVC (#1650)

Add  option to avoid adding  to msvc command line for non-utf8 source code

chore: Mark some ThreadPool methods as noexcept

feat: Log errors and size changes when recompressing cache files

enhance: Let ThreadPool log failed tasks

enhance: Make logging system thread-safe

perf: Only wake up one worker thread when a task has been popped

fix: Handle util::TaskPool enqueue/shut_down called by different threads

enhance: Add util::parse_base16 function

enhance: Add util::Bytes::push_back method

enhance: Add util::Bytes::at method

docs: Update URLs in manual and news

fix: Correctly remove mismatching manifest file

This fixes a bug introduced in commit c7c0837a ("Refactor main primary
storage backend code into storage/primary").

perf: Avoid zero-filling in util::Bytes in all cases

enhance: Add more util::Bytes constructor and operator= variants

perf: Call Bytes::resize from Bytes constructors to avoid zero-filling

enhance: Add Bytes::erase

test: Use REQUIRE for Bytes::size when indexing bytes later

chore: Consistently use .reset() to reset m_data in Bytes

fix: Fix comparison of empty Bytes objects

feat: Add support for multi-line configuration values

fix: Pass unsigned char to std::is* and std::tolower

Passing (negative) char is technically undefined behavior.

docs: Mention that sloppiness values can be whitespace-separated

docs: Tweak Asciidoc markup

feat: Add support for -fcoverage-compilation-dir/-fcoverage-prefix-map (#1644)

chore: Update C++ standard in .clang-format (#1648)

chore: Add libstdc++-static to alma dockerfiles

docs: Improve installation guide

docs: Improve manual

feat: Support rewriting absolute path for -fsanitize-blacklist (#1647)

test: Fix `profiling_clang` test (#1642)

chore: Fix typo in CcacheVersion (#1645)

ci: Add missing dependency on build_documentation for build_release

docs: Fix `install.md` links after renaming (#1643)

docs: Improve documentation on statistics counters and --zero-stats

After discussion with Otto Kekäläinen in #1639.

Co-authored by: Otto Kekäläinen <otto@kekalainen.net>

docs: Reflow long line in manual

docs: Reconcile max-size suffixes in documentation (#1640)

* Use explicit 'GB' suffix in example.
* Fix misleading `max_size` description. Default suffix is GiB, not GB. And default value is 5GiB also.
* `max_size` description - use explicit suffixes.

fix: Link with libsocket on SunOS/Illumos

Closes #1638.

chore: Ignore local copilot instructions

chore: Improve util::FileLock

- Release current lock on move.
- Check for invalid file descriptor in acquire/release.
- Use UnlockFileEx on Windows for symmetry with LockFileEx.
- Added noexcept where applicable.

refactor: Use std::chrono instead of custom classes

chore: Update authors

(cherry picked from commit dd29ee832c5ba130d877c16c06e1c3b6dd55247a)

chore: Update NEWS

(cherry picked from commit acf9688b448844d931002c26e0cf5ee02f8f47ba)

chore: Update NEWS

(cherry picked from commit 058808b676ed0bde0dea5a91434fe5615af2113f)

chore: Update NEWS

(cherry picked from commit a50e311cbd4c756fdedf6acd50ee2e8753330587)

fix: Add missing return in copy_file_impl fallback code (#1630)

This fixes a compilation error with tl::expected ≥ 1.2.0 on non-Apple platforms where sendfile(2) is not available.

fix: Add missing doc files to Linux/macOS binary release packages

chore: Avoid false positive spelling warning with typos 1.37.0

fix: Use monotonic clock for spin locks in inode cache

docs: Rename documentation files to lowercase

Exception: Doc files at the top level keep their uppercase names by
convention.

docs: Generate documention in Markdown format as well

docs: Escape hash character in asciidoc file

Asciidoctor gets confused otherwise when generating docbook.

fix: Handle -Xarch_host/-Xarch_device except with other -Xarch_*

-Xarch_host and -Xarch_device appear to have different semantics than
other -Xarch_* options, so add special case code that allows only
-Xarch_host options or only -Xarch_device options while falling back to
the compiler for other combinations.

A future improvement would be to add multi-pass support for -Xarch_host
and -Xarch_device combinations as well.

Fixes #1632.

bump: Upgrade to fmt 12.0.0