/** * Copyright (C) 2022-present MongoDB, Inc. * * This program is free software: you can redistribute it and/or modify * it under the terms of the Server Side Public License, version 1, * as published by MongoDB, Inc. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * Server Side Public License for more details. * * You should have received a copy of the Server Side Public License * along with this program. If not, see * . * * As a special exception, the copyright holders give permission to link the * code of portions of this program with the OpenSSL library under certain * conditions as described in each individual source file and distribute * linked combinations including the program with the OpenSSL library. You * must comply with the Server Side Public License in all respects for * all of the code used other than as permitted herein. If you modify file(s) * with this exception, you may extend this exception to your version of the * file(s), but you are not obligated to do so. If you do not wish to do so, * delete this exception statement from your version. If you delete this * exception statement from all source files in the program, then also delete * it in the license file. */ #pragma once #include #include #include #include #include #include #include #include #include #include #include "mongo/base/error_codes.h" #include "mongo/base/string_data.h" #include "mongo/stdx/type_traits.h" #include "mongo/util/optional_util.h" /** * Mechanisms and extensibility hooks used by this library to format arbitrary * user-provided objects. */ namespace mongo::unittest::stringify { std::string formatTypedObj(const std::type_info& ti, StringData obj); std::string lastResortFormat(const std::type_info& ti, const void* p, size_t sz); /** * `stringifyForAssert` can be overloaded to extend stringification * capabilities of the matchers via ADL. * * The overload in this namespace is used for types for * which the unittest library has built-in support. */ template std::string stringifyForAssert(const T& x); template std::string doFormat(const T& x) { return format(FMT_STRING("{}"), x); } template std::string doOstream(const T& x) { std::ostringstream os; os << x; return os.str(); } using std::begin; using std::end; template using HasToStringOp = decltype(std::declval().toString()); template constexpr bool HasToString = stdx::is_detected_v; template using HasBeginEndOp = std::tuple())), decltype(end(std::declval()))>; template constexpr bool IsSequence = stdx::is_detected_v; template using IsTupleOp = decltype(std::tuple_size::value); template constexpr bool IsTuple = stdx::is_detected_v; class Joiner { public: template Joiner& operator()(const T& v) { _out += format(FMT_STRING("{}{}"), _sep, stringifyForAssert(v)); _sep = ", "; return *this; } explicit operator const std::string&() const { return _out; } private: std::string _out; const char* _sep = ""; }; template std::string doSequence(const T& seq) { std::string r; Joiner joiner; for (const auto& e : seq) joiner(e); return format(FMT_STRING("[{}]"), std::string{joiner}); } template std::string doTuple(const T& tup, std::index_sequence) { Joiner joiner; (joiner(std::get(tup)), ...); return format(FMT_STRING("({})"), std::string{joiner}); } template std::string doTuple(const T& tup) { return doTuple(tup, std::make_index_sequence>{}); } /** * The default stringifyForAssert implementation. * Encodes the steps by which we determine how to print an object. * There's a wildcard branch so everything is printable in some way. */ template std::string stringifyForAssert(const T& x) { if constexpr (optional_io::canStreamWithExtension) { return doOstream(optional_io::Extension{x}); } else if constexpr (HasToString) { return x.toString(); } else if constexpr (std::is_convertible_v) { return doFormat(StringData(x)); } else if constexpr (std::is_pointer_v) { return doFormat(static_cast(x)); } else if constexpr (IsSequence) { return doSequence(x); } else if constexpr (IsTuple) { return doTuple(x); } else if constexpr (std::is_enum_v) { return formatTypedObj(typeid(T), doFormat(static_cast>(x))); } else { return lastResortFormat(typeid(x), &x, sizeof(x)); } } /** Portably support stringifying `nullptr`. */ inline std::string stringifyForAssert(std::nullptr_t) { return "nullptr"; } /** Built-in support to stringify `ErrorCode::Error`. */ inline std::string stringifyForAssert(ErrorCodes::Error ec) { return ErrorCodes::errorString(ec); } } // namespace mongo::unittest::stringify