CMake/Source/cmGlobVerificationManager.h
Kitware Robot 0b96ae1f6a Revise C++ coding style using clang-format with "east const"
Run the `clang-format.bash` script to update all our C and C++ code to a
new style defined by `.clang-format`, now with "east const" enforcement.
Use `clang-format` version 18.

* If you reached this commit for a line in `git blame`, re-run the blame
  operation starting at the parent of this commit to see older history
  for the content.

* See the parent commit for instructions to rebase a change across this
  style transition commit.

Issue: #26123
2025-01-23 13:09:50 -05:00

86 lines
2.5 KiB
C++

/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
file Copyright.txt or https://cmake.org/licensing for details. */
#pragma once
#include "cmConfigure.h" // IWYU pragma: keep
#include <iosfwd>
#include <map>
#include <string>
#include <utility>
#include <vector>
#include "cmListFileCache.h"
class cmMessenger;
struct cmGlobCacheEntry;
/** \class cmGlobVerificationManager
* \brief Class for expressing build-time dependencies on glob expressions.
*
* Generates a CMake script which verifies glob outputs during prebuild.
*
*/
class cmGlobVerificationManager
{
protected:
//! Save verification script for given makefile.
//! Saves to output <path>/<CMakeFilesDirectory>/VerifyGlobs.cmake
bool SaveVerificationScript(std::string const& path, cmMessenger* messenger);
//! Add an entry into the glob cache
void AddCacheEntry(cmGlobCacheEntry const& entry,
std::string const& variable,
cmListFileBacktrace const& bt, cmMessenger* messenger);
//! Get all cache entries
std::vector<cmGlobCacheEntry> GetCacheEntries() const;
//! Clear the glob cache for state reset.
void Reset();
//! Check targets should be written in generated build system.
bool DoWriteVerifyTarget() const;
//! Get the paths to the generated script and stamp files
std::string const& GetVerifyScript() const { return this->VerifyScript; }
std::string const& GetVerifyStamp() const { return this->VerifyStamp; }
private:
struct CacheEntryKey
{
bool const Recurse;
bool const ListDirectories;
bool const FollowSymlinks;
std::string const Relative;
std::string const Expression;
CacheEntryKey(bool const rec, bool const l, bool const s, std::string rel,
std::string e)
: Recurse(rec)
, ListDirectories(l)
, FollowSymlinks(s)
, Relative(std::move(rel))
, Expression(std::move(e))
{
}
bool operator<(CacheEntryKey const& r) const;
void PrintGlobCommand(std::ostream& out, std::string const& cmdVar);
};
struct CacheEntryValue
{
bool Initialized = false;
std::vector<std::string> Files;
std::vector<std::pair<std::string, cmListFileBacktrace>> Backtraces;
};
using CacheEntryMap = std::map<CacheEntryKey, CacheEntryValue>;
CacheEntryMap Cache;
std::string VerifyScript;
std::string VerifyStamp;
// Only cmState should be able to add cache values.
// cmGlobVerificationManager should never be used directly.
friend class cmState; // allow access to add cache values
};