Files
OpenSpace/include/openspace/documentation/verifier.h

385 lines
15 KiB
C++

/*****************************************************************************************
* *
* OpenSpace *
* *
* Copyright (c) 2014-2016 *
* *
* Permission is hereby granted, free of charge, to any person obtaining a copy of this *
* software and associated documentation files (the "Software"), to deal in the Software *
* without restriction, including without limitation the rights to use, copy, modify, *
* merge, publish, distribute, sublicense, and/or sell copies of the Software, and to *
* permit persons to whom the Software is furnished to do so, subject to the following *
* conditions: *
* *
* The above copyright notice and this permission notice shall be included in all copies *
* or substantial portions of the Software. *
* *
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, *
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A *
* PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT *
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF *
* CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE *
* OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
****************************************************************************************/
#ifndef __VERIFIER_H__
#define __VERIFIER_H__
#include <openspace/documentation/documentation.h>
#include <functional>
namespace openspace {
namespace documentation {
struct Verifier {
virtual TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const = 0;
virtual std::string type() const = 0;
virtual std::string documentation() const;
};
// General verifiers
template <typename T>
struct TemplateVerifier : public Verifier {
using Type = T;
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
};
struct BoolVerifier : public TemplateVerifier<bool> {
std::string type() const override;
};
struct DoubleVerifier : public TemplateVerifier<double> {
std::string type() const override;
};
struct IntVerifier : public TemplateVerifier<int> {
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string type() const override;
};
struct StringVerifier : public TemplateVerifier<std::string> {
std::string type() const override;
};
struct TableVerifier : public TemplateVerifier<ghoul::Dictionary> {
TableVerifier(std::vector<DocumentationEntry> d = {},
Exhaustive exhaustive = Exhaustive::No);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string type() const override;
std::vector<DocumentationEntry> doc;
Exhaustive exhaustive;
};
struct VectorVerifier {};
template <typename T>
struct Vector2Verifier : public TemplateVerifier<glm::tvec2<T>>, public VectorVerifier {
std::string type() const override;
};
template <typename T>
struct Vector3Verifier : public TemplateVerifier<glm::tvec3<T>>, public VectorVerifier {
std::string type() const override;
};
template <typename T>
struct Vector4Verifier : public TemplateVerifier<glm::tvec4<T>>, public VectorVerifier {
std::string type() const override;
};
// Operator Verifiers
template <typename T, typename Op>
struct OperatorVerifier : public T {
OperatorVerifier(typename T::Type value);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
typename T::Type value;
};
template <typename T>
struct LessVerifier : public OperatorVerifier<T, std::less<typename T::Type>> {
static_assert(!std::is_base_of_v<BoolVerifier, T>, "T cannot be BoolVerifier");
static_assert(!std::is_base_of_v<StringVerifier, T>, "T cannot be StringVerifier");
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
static_assert(!std::is_base_of_v<VectorVerifier, T>, "T cannot be VectorVerifier");
using OperatorVerifier::OperatorVerifier;
std::string documentation() const;
};
template <typename T>
struct LessEqualVerifier : public OperatorVerifier<T, std::less_equal<typename T::Type>> {
static_assert(!std::is_base_of_v<BoolVerifier, T>, "T cannot be BoolVerifier");
static_assert(!std::is_base_of_v<StringVerifier, T>, "T cannot be StringVerifier");
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
static_assert(!std::is_base_of_v<VectorVerifier, T>, "T cannot be VectorVerifier");
using OperatorVerifier::OperatorVerifier;
std::string documentation() const override;
};
template <typename T>
struct GreaterVerifier : public OperatorVerifier<T, std::greater<typename T::Type>> {
static_assert(!std::is_base_of_v<BoolVerifier, T>, "T cannot be BoolVerifier");
static_assert(!std::is_base_of_v<StringVerifier, T>, "T cannot be StringVerifier");
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
static_assert(!std::is_base_of_v<VectorVerifier, T>, "T cannot be VectorVerifier");
using OperatorVerifier::OperatorVerifier;
std::string documentation() const override;
};
template <typename T>
struct GreaterEqualVerifier : public OperatorVerifier<T, std::greater_equal<typename T::Type>> {
static_assert(!std::is_base_of_v<BoolVerifier, T>, "T cannot be BoolVerifier");
static_assert(!std::is_base_of_v<StringVerifier, T>, "T cannot be StringVerifier");
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
static_assert(!std::is_base_of_v<VectorVerifier, T>, "T cannot be VectorVerifier");
using OperatorVerifier::OperatorVerifier;
std::string documentation() const override;
};
template <typename T>
struct EqualVerifier : public OperatorVerifier<T, std::equal_to<typename T::Type>> {
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
using OperatorVerifier::OperatorVerifier;
std::string documentation() const override;
};
template <typename T>
struct UnequalVerifier : public OperatorVerifier<T, std::not_equal_to<typename T::Type>> {
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
using OperatorVerifier::OperatorVerifier;
std::string documentation() const override;
};
// List Verifiers
template <typename T>
struct InListVerifier : public T {
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
InListVerifier(std::vector<typename T::Type> values);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string documentation() const override;
std::vector<typename T::Type> values;
};
template <typename T>
struct NotInListVerifier : public T {
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
NotInListVerifier(std::vector<typename T::Type> values);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string documentation() const override;
std::vector<typename T::Type> values;
};
// Range Verifiers
template <typename T>
struct InRangeVerifier : public T {
static_assert(!std::is_base_of_v<BoolVerifier, T>, "T cannot be BoolVerifier");
static_assert(!std::is_base_of_v<StringVerifier, T>, "T cannot be StringVerifier");
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
static_assert(!std::is_base_of_v<VectorVerifier, T>, "T cannot be VectorVerifier");
InRangeVerifier(typename T::Type lower, typename T::Type upper);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string documentation() const override;
typename T::Type lower;
typename T::Type upper;
};
template <typename T>
struct NotInRangeVerifier : public T {
static_assert(!std::is_base_of_v<BoolVerifier, T>, "T cannot be BoolVerifier");
static_assert(!std::is_base_of_v<StringVerifier, T>, "T cannot be StringVerifier");
static_assert(!std::is_base_of_v<TableVerifier, T>, "T cannot be TableVerifier");
static_assert(!std::is_base_of_v<VectorVerifier, T>, "T cannot be VectorVerifier");
NotInRangeVerifier(typename T::Type lower, typename T::Type upper);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string documentation() const override;
typename T::Type lower;
typename T::Type upper;
};
// Misc Verifiers
template <typename T>
struct AnnotationVerifier : public T {
AnnotationVerifier(std::string annotation);
std::string documentation() const override;
std::string annotation;
};
// Boolean Verifiers
struct AndVerifier : public Verifier {
AndVerifier(Verifier* a, Verifier* b);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string type() const override;
std::string documentation() const override;
std::shared_ptr<Verifier> a;
std::shared_ptr<Verifier> b;
};
struct OrVerifier : public Verifier {
OrVerifier(Verifier* a, Verifier* b);
TestResult operator()(const ghoul::Dictionary& dict,
const std::string& key) const override;
std::string type() const override;
std::string documentation() const override;
std::shared_ptr<Verifier> a;
std::shared_ptr<Verifier> b;
};
using BoolVector2Verifier = Vector2Verifier<bool>;
using IntVector2Verifier = Vector2Verifier<int>;
using DoubleVector2Verifier = Vector2Verifier<double>;
using BoolVector3Verifier = Vector3Verifier<bool>;
using IntVector3Verifier = Vector3Verifier<int>;
using DoubleVector3Verifier = Vector3Verifier<double>;
using BoolVector4Verifier = Vector4Verifier<bool>;
using IntVector4Verifier = Vector4Verifier<int>;
using DoubleVector4Verifier = Vector4Verifier<double>;
using IntLessVerifier = LessVerifier<IntVerifier>;
using DoubleLessVerifier = LessVerifier<DoubleVerifier>;
using IntLessEqualVerifier = LessEqualVerifier<IntVerifier>;
using DoubleLessEqualVerifier = LessEqualVerifier<DoubleVerifier>;
using IntGreaterVerifier = GreaterVerifier<IntVerifier>;
using DoubleGreaterVerifier = GreaterVerifier<DoubleVerifier>;
using IntGreaterEqualVerifier = GreaterEqualVerifier<IntVerifier>;
using DoubleGreaterEqualVerifier = GreaterEqualVerifier<DoubleVerifier>;
using BoolEqualVerifier = EqualVerifier<BoolVerifier>;
using IntEqualVerifier = EqualVerifier<IntVerifier>;
using DoubleEqualVerifier = EqualVerifier<DoubleVerifier>;
using StringEqualVerifier = EqualVerifier<StringVerifier>;
using BoolUnequalVerifier = UnequalVerifier<BoolVerifier>;
using IntUnequalVerifier = UnequalVerifier<IntVerifier>;
using DoubleUnequalVerifier = UnequalVerifier<DoubleVerifier>;
using StringUnequalVerifier = UnequalVerifier<StringVerifier>;
using BoolInListVerifier = InListVerifier<BoolVerifier>;
using IntInListVerifier = InListVerifier<IntVerifier>;
using DoubleInListVerifier = InListVerifier<DoubleVerifier>;
using StringInListVerifier = InListVerifier<StringVerifier>;
using BoolNotInListVerifier = NotInListVerifier<BoolVerifier>;
using IntNotInListVerifier = NotInListVerifier<IntVerifier>;
using DoubleNotInListVerifier = NotInListVerifier<DoubleVerifier>;
using StringNotInListVerifier = NotInListVerifier<StringVerifier>;
using IntInRangeVerifier = InRangeVerifier<IntVerifier>;
using DoubleInRangeVerifier = InRangeVerifier<DoubleVerifier>;
using IntNotInRangeVerifier = NotInRangeVerifier<IntVerifier>;
using DoubleNotInRangeVerifier = NotInRangeVerifier<DoubleVerifier>;
using BoolAnnotationVerifier = AnnotationVerifier<BoolVerifier>;
using IntAnnotationVerifier = AnnotationVerifier<IntVerifier>;
using DoubleAnnotationVerifier = AnnotationVerifier<DoubleVerifier>;
using StringAnnotationVerifier = AnnotationVerifier<StringVerifier>;
using TableAnnotationVerifier = AnnotationVerifier<TableVerifier>;
extern template struct Vector2Verifier<bool>;
extern template struct Vector2Verifier<int>;
extern template struct Vector2Verifier<double>;
extern template struct Vector3Verifier<bool>;
extern template struct Vector3Verifier<int>;
extern template struct Vector3Verifier<double>;
extern template struct Vector4Verifier<bool>;
extern template struct Vector4Verifier<int>;
extern template struct Vector4Verifier<double>;
extern template struct LessVerifier<IntVerifier>;
extern template struct LessVerifier<DoubleVerifier>;
extern template struct LessEqualVerifier<IntVerifier>;
extern template struct LessEqualVerifier<DoubleVerifier>;
extern template struct GreaterVerifier<IntVerifier>;
extern template struct GreaterVerifier<DoubleVerifier>;
extern template struct GreaterEqualVerifier<IntVerifier>;
extern template struct GreaterEqualVerifier<DoubleVerifier>;
extern template struct EqualVerifier<BoolVerifier>;
extern template struct EqualVerifier<IntVerifier>;
extern template struct EqualVerifier<DoubleVerifier>;
extern template struct EqualVerifier<StringVerifier>;
extern template struct UnequalVerifier<BoolVerifier>;
extern template struct UnequalVerifier<IntVerifier>;
extern template struct UnequalVerifier<DoubleVerifier>;
extern template struct UnequalVerifier<StringVerifier>;
extern template struct InListVerifier<BoolVerifier>;
extern template struct InListVerifier<IntVerifier>;
extern template struct InListVerifier<DoubleVerifier>;
extern template struct InListVerifier<StringVerifier>;
extern template struct NotInListVerifier<BoolVerifier>;
extern template struct NotInListVerifier<IntVerifier>;
extern template struct NotInListVerifier<DoubleVerifier>;
extern template struct NotInListVerifier<StringVerifier>;
extern template struct InRangeVerifier<IntVerifier>;
extern template struct InRangeVerifier<DoubleVerifier>;
extern template struct NotInRangeVerifier<IntVerifier>;
extern template struct NotInRangeVerifier<DoubleVerifier>;
extern template struct AnnotationVerifier<BoolVerifier>;
extern template struct AnnotationVerifier<IntVerifier>;
extern template struct AnnotationVerifier<DoubleVerifier>;
extern template struct AnnotationVerifier<StringVerifier>;
extern template struct AnnotationVerifier<TableVerifier>;
} // namespace documentation
} // namespace openspace
#include "verifier.inl"
#endif // __VERIFIER_H__