diff options
| author | Amlal El Mahrouss <amlal@nekernel.org> | 2025-08-16 20:00:37 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-08-16 20:00:37 +0200 |
| commit | d21a3b2e16b4e5f974dd000e11c868e2021292f0 (patch) | |
| tree | d91d1351193a9f758daa9dad964e40f5a84ece7f /vendor/toml++/impl/yaml_formatter.hpp | |
| parent | 50c2c9773d5660b1497a1132ffa96a7ab10d9c45 (diff) | |
| parent | d987d62459d59a6d95ffb815d5e6eccd8dbde1dd (diff) | |
Merge pull request #3 from nekernel-org/dev
v0.0.3
Diffstat (limited to 'vendor/toml++/impl/yaml_formatter.hpp')
| -rw-r--r-- | vendor/toml++/impl/yaml_formatter.hpp | 139 |
1 files changed, 139 insertions, 0 deletions
diff --git a/vendor/toml++/impl/yaml_formatter.hpp b/vendor/toml++/impl/yaml_formatter.hpp new file mode 100644 index 0000000..1a3d24f --- /dev/null +++ b/vendor/toml++/impl/yaml_formatter.hpp @@ -0,0 +1,139 @@ +//# This file is a part of toml++ and is subject to the the terms of the MIT license. +//# Copyright (c) Mark Gillard <mark.gillard@outlook.com.au> +//# See https://github.com/marzer/tomlplusplus/blob/master/LICENSE for the full license text. +// SPDX-License-Identifier: MIT +#pragma once + +#include "preprocessor.hpp" +#if TOML_ENABLE_FORMATTERS + +#include "formatter.hpp" +#include "header_start.hpp" + +TOML_NAMESPACE_START +{ + /// \brief A wrapper for printing TOML objects out to a stream as formatted YAML. + /// + /// \availability This class is only available when #TOML_ENABLE_FORMATTERS is enabled. + /// + /// \detail \cpp + /// auto some_toml = toml::parse(R"( + /// [fruit] + /// apple.color = "red" + /// apple.taste.sweet = true + /// + /// [fruit.apple.texture] + /// smooth = true + /// )"sv); + /// std::cout << toml::yaml_formatter{ some_toml } << "\n"; + /// \ecpp + /// + /// \out + /// fruit: + /// apple: + /// color: red + /// taste: + /// sweet: true + /// texture: + /// smooth: true + /// \eout + class TOML_EXPORTED_CLASS yaml_formatter : impl::formatter + { + private: + /// \cond + + using base = impl::formatter; + + TOML_EXPORTED_MEMBER_FUNCTION + void print_yaml_string(const value<std::string>&); + + TOML_EXPORTED_MEMBER_FUNCTION + void print(const toml::table&, bool = false); + + TOML_EXPORTED_MEMBER_FUNCTION + void print(const toml::array&, bool = false); + + TOML_EXPORTED_MEMBER_FUNCTION + void print(); + + static constexpr impl::formatter_constants constants = { + // + format_flags::quote_dates_and_times | format_flags::indentation, // mandatory + format_flags::allow_multi_line_strings, // ignored + ".inf"sv, + "-.inf"sv, + ".NAN"sv, + "true"sv, + "false"sv + }; + + /// \endcond + + public: + /// \brief The default flags for a yaml_formatter. + static constexpr format_flags default_flags = constants.mandatory_flags // + | format_flags::allow_literal_strings // + | format_flags::allow_unicode_strings // + | format_flags::allow_octal_integers // + | format_flags::allow_hexadecimal_integers; + + /// \brief Constructs a YAML formatter and binds it to a TOML object. + /// + /// \param source The source TOML object. + /// \param flags Format option flags. + TOML_NODISCARD_CTOR + explicit yaml_formatter(const toml::node& source, format_flags flags = default_flags) noexcept + : base{ &source, nullptr, constants, { flags, " "sv } } + {} + +#if TOML_DOXYGEN || (TOML_ENABLE_PARSER && !TOML_EXCEPTIONS) + + /// \brief Constructs a YAML formatter and binds it to a toml::parse_result. + /// + /// \availability This constructor is only available when exceptions are disabled. + /// + /// \attention Formatting a failed parse result will simply dump the error message out as-is. + /// This will not be valid YAML, but at least gives you something to log or show up in diagnostics: + /// \cpp + /// std::cout << toml::yaml_formatter{ toml::parse("a = 'b'"sv) } // ok + /// << "\n\n" + /// << toml::yaml_formatter{ toml::parse("a = "sv) } // malformed + /// << "\n"; + /// \ecpp + /// \out + /// a: b + /// + /// Error while parsing key-value pair: encountered end-of-file + /// (error occurred at line 1, column 5) + /// \eout + /// Use the library with exceptions if you want to avoid this scenario. + /// + /// \param result The parse result. + /// \param flags Format option flags. + TOML_NODISCARD_CTOR + explicit yaml_formatter(const toml::parse_result& result, format_flags flags = default_flags) noexcept + : base{ nullptr, &result, constants, { flags, " "sv } } + {} + +#endif + + /// \brief Prints the bound TOML object out to the stream as YAML. + friend std::ostream& TOML_CALLCONV operator<<(std::ostream& lhs, yaml_formatter& rhs) + { + rhs.attach(lhs); + rhs.print(); + rhs.detach(); + return lhs; + } + + /// \brief Prints the bound TOML object out to the stream as YAML (rvalue overload). + friend std::ostream& TOML_CALLCONV operator<<(std::ostream& lhs, yaml_formatter&& rhs) + { + return lhs << rhs; // as lvalue + } + }; +} +TOML_NAMESPACE_END; + +#include "header_end.hpp" +#endif // TOML_ENABLE_FORMATTERS |
