psOff_public/tools/gamereport/git_ver.h

161 lines
4.0 KiB
C
Raw Permalink Normal View History

2024-04-07 19:00:20 +00:00
#pragma once
// git.h
// https://raw.githubusercontent.com/andrew-hardin/cmake-git-version-tracking/master/git.h
//
// Released under the MIT License.
// https://raw.githubusercontent.com/andrew-hardin/cmake-git-version-tracking/master/LICENSE
#include <stdbool.h>
#ifdef __cplusplus
#define GIT_VERSION_TRACKING_EXTERN_C_BEGIN extern "C" {
#define GIT_VERSION_TRACKING_EXTERN_C_END }
#else
#define GIT_VERSION_TRACKING_EXTERN_C_BEGIN
#define GIT_VERSION_TRACKING_EXTERN_C_END
#endif
// Don't mangle the C function names if included in a CXX file.
GIT_VERSION_TRACKING_EXTERN_C_BEGIN
/// Is the metadata populated?
//
/// We may not have metadata if there wasn't a .git directory
/// (e.g. downloaded source code without revision history).
bool git_IsPopulated();
/// Were there any uncommitted changes that won't be reflected
/// in the CommitID?
bool git_AnyUncommittedChanges();
/// The commit author's name.
const char* git_AuthorName();
/// The commit author's email.
const char* git_AuthorEmail();
/// The commit SHA1.
const char* git_CommitSHA1();
/// The ISO8601 commit date.
const char* git_CommitDate();
/// The commit subject.
const char* git_CommitSubject();
/// The commit body.
const char* git_CommitBody();
/// The commit describe.
const char* git_Describe();
/// The symbolic reference tied to HEAD.
const char* git_Branch();
GIT_VERSION_TRACKING_EXTERN_C_END
#undef GIT_VERSION_TRACKING_EXTERN_C_BEGIN
#undef GIT_VERSION_TRACKING_EXTERN_C_END
#ifdef __cplusplus
/// This is a utility extension for C++ projects.
/// It provides a "git" namespace that wraps the
/// C methods in more(?) ergonomic types.
///
/// This is header-only in an effort to keep the
/// underlying static library C99 compliant.
// We really want to use std::string_view if it appears
// that the compiler will support it. If that fails,
// revert back to std::string.
#define GIT_VERSION_TRACKING_CPP_17_STANDARD 201703L
#if __cplusplus >= GIT_VERSION_TRACKING_CPP_17_STANDARD
#define GIT_VERSION_USE_STRING_VIEW 1
#else
#define GIT_VERSION_USE_STRING_VIEW 0
#endif
#if GIT_VERSION_USE_STRING_VIEW
#include <cstring>
#include <string_view>
#else
#include <string>
#endif
namespace git {
#if GIT_VERSION_USE_STRING_VIEW
using StringOrView = std::string_view;
#else
typedef std::string StringOrView;
#endif
namespace internal {
/// Short-hand method for initializing a std::string or std::string_view given a C-style const char*.
inline const StringOrView InitString(const char* from_c_interface) {
#if GIT_VERSION_USE_STRING_VIEW
return StringOrView {from_c_interface, std::strlen(from_c_interface)};
#else
return std::string(from_c_interface);
#endif
}
} // namespace internal
inline bool IsPopulated() {
return git_IsPopulated();
}
inline bool AnyUncommittedChanges() {
return git_AnyUncommittedChanges();
}
inline const StringOrView& AuthorName() {
static const StringOrView kValue = internal::InitString(git_AuthorName());
return kValue;
}
inline const StringOrView AuthorEmail() {
static const StringOrView kValue = internal::InitString(git_AuthorEmail());
return kValue;
}
inline const StringOrView CommitSHA1() {
static const StringOrView kValue = internal::InitString(git_CommitSHA1());
return kValue;
}
inline const StringOrView CommitDate() {
static const StringOrView kValue = internal::InitString(git_CommitDate());
return kValue;
}
inline const StringOrView CommitSubject() {
static const StringOrView kValue = internal::InitString(git_CommitSubject());
return kValue;
}
inline const StringOrView CommitBody() {
static const StringOrView kValue = internal::InitString(git_CommitBody());
return kValue;
}
inline const StringOrView Describe() {
static const StringOrView kValue = internal::InitString(git_Describe());
return kValue;
}
inline const StringOrView Branch() {
static const StringOrView kValue = internal::InitString(git_Branch());
return kValue;
}
} // namespace git
// Cleanup our defines to avoid polluting.
#undef GIT_VERSION_USE_STRING_VIEW
#undef GIT_VERSION_TRACKING_CPP_17_STANDARD
#endif // __cplusplus