geode/loader/include/Geode/utils/VersionInfo.hpp

136 lines
4.6 KiB
C++
Raw Normal View History

2022-07-30 12:24:03 -04:00
#pragma once
#include "../DefaultInclude.hpp"
2022-07-30 12:24:03 -04:00
#include <string_view>
#include "../external/json/json_fwd.hpp"
#include <tuple>
#include "../utils/Result.hpp"
2022-07-30 12:24:03 -04:00
namespace geode {
enum class VersionCompare {
LessEq,
Exact,
MoreEq,
};
2022-07-30 12:24:03 -04:00
/**
2022-12-12 08:45:27 -05:00
* A version label, like v1.0.0-alpha or v2.3.4-prerelease. Purely semantic,
* and not used in comparisons; so for example v1.0.0-alpha == v1.0.0.
*/
enum class VersionTag {
Alpha,
Beta,
Prerelease,
};
GEODE_DLL std::optional<VersionTag> versionTagFromString(std::string const& str);
GEODE_DLL std::string versionTagToSuffixString(VersionTag tag);
GEODE_DLL std::string versionTagToString(VersionTag tag);
/**
* Class representing version information. Not strictly semver, notably in
* regard to identifiers; identifiers are restricted to a few common ones,
* and are purely semantic, i.e. not used in comparisons. See VersionTag
* for details
2022-07-30 12:24:03 -04:00
* @class VersionInfo
*/
class GEODE_DLL VersionInfo final {
2022-07-30 12:24:03 -04:00
protected:
2022-12-12 08:45:27 -05:00
size_t m_major = 1;
size_t m_minor = 0;
size_t m_patch = 0;
std::optional<VersionTag> m_tag;
2022-10-30 14:59:20 -04:00
2022-07-30 12:24:03 -04:00
public:
2022-12-08 15:04:02 -05:00
constexpr VersionInfo() = default;
2022-12-12 08:45:27 -05:00
constexpr VersionInfo(size_t major, size_t minor, size_t patch) {
m_major = major;
m_minor = minor;
m_patch = patch;
}
constexpr VersionInfo(
size_t major, size_t minor, size_t patch,
std::optional<VersionTag> tag
) {
2022-07-30 12:24:03 -04:00
m_major = major;
m_minor = minor;
m_patch = patch;
2022-12-12 08:45:27 -05:00
m_tag = tag;
2022-07-30 12:24:03 -04:00
}
static Result<VersionInfo> parse(std::string const& string);
2022-07-30 12:24:03 -04:00
2022-12-12 08:45:27 -05:00
constexpr size_t getMajor() const {
2022-12-08 15:04:02 -05:00
return m_major;
}
2022-07-30 12:24:03 -04:00
2022-12-12 08:45:27 -05:00
constexpr size_t getMinor() const {
2022-12-08 15:04:02 -05:00
return m_minor;
}
2022-07-30 12:24:03 -04:00
2022-12-12 08:45:27 -05:00
constexpr size_t getPatch() const {
2022-12-08 15:04:02 -05:00
return m_patch;
}
2022-12-12 08:45:27 -05:00
constexpr std::optional<VersionTag> getTag() const {
return m_tag;
}
// Apple clang does not support operator<=>! Yippee!
constexpr bool operator==(VersionInfo const& other) const {
return std::tie(m_major, m_minor, m_patch) ==
std::tie(other.m_major, other.m_minor, other.m_patch);
}
constexpr bool operator<(VersionInfo const& other) const {
return std::tie(m_major, m_minor, m_patch) <
std::tie(other.m_major, other.m_minor, other.m_patch);
}
constexpr bool operator<=(VersionInfo const& other) const {
return std::tie(m_major, m_minor, m_patch) <=
std::tie(other.m_major, other.m_minor, other.m_patch);
}
constexpr bool operator>(VersionInfo const& other) const {
return std::tie(m_major, m_minor, m_patch) >
std::tie(other.m_major, other.m_minor, other.m_patch);
}
constexpr bool operator>=(VersionInfo const& other) const {
return std::tie(m_major, m_minor, m_patch) >=
2022-12-08 15:04:02 -05:00
std::tie(other.m_major, other.m_minor, other.m_patch);
}
2022-07-30 12:24:03 -04:00
2022-12-12 08:45:27 -05:00
std::string toString(bool includeTag = true) const;
2022-07-30 12:24:03 -04:00
};
2022-11-22 17:35:08 -05:00
void GEODE_DLL to_json(nlohmann::json& json, VersionInfo const& info);
void GEODE_DLL from_json(nlohmann::json const& json, VersionInfo& info);
GEODE_DLL std::ostream& operator<<(std::ostream& stream, VersionInfo const& version);
2022-11-22 17:35:08 -05:00
class GEODE_DLL ComparableVersionInfo final {
protected:
VersionInfo m_version;
VersionCompare m_compare = VersionCompare::Exact;
public:
constexpr ComparableVersionInfo() = default;
constexpr ComparableVersionInfo(
VersionInfo const& version,
VersionCompare const& compare
) : m_version(version), m_compare(compare) {}
static Result<ComparableVersionInfo> parse(std::string const& string);
constexpr bool compare(VersionInfo const& version) const {
switch (m_compare) {
case VersionCompare::Exact: return m_version == version; break;
case VersionCompare::LessEq: return m_version <= version; break;
case VersionCompare::MoreEq: return m_version >= version; break;
}
return false;
}
std::string toString() const;
};
void GEODE_DLL to_json(nlohmann::json& json, ComparableVersionInfo const& info);
void GEODE_DLL from_json(nlohmann::json const& json, ComparableVersionInfo& info);
GEODE_DLL std::ostream& operator<<(std::ostream& stream, ComparableVersionInfo const& version);
2022-07-30 12:24:03 -04:00
}