serenity/AK/SourceGenerator.h

140 lines
3.5 KiB
C
Raw Normal View History

2020-10-11 17:57:43 +00:00
/*
* Copyright (c) 2020, the SerenityOS developers.
* Copyright (c) 2023, Sam Atkins <atkinssj@serenityos.org>
2020-10-11 17:57:43 +00:00
*
* SPDX-License-Identifier: BSD-2-Clause
2020-10-11 17:57:43 +00:00
*/
#pragma once
#include <AK/DeprecatedString.h>
2020-10-11 17:57:43 +00:00
#include <AK/GenericLexer.h>
#include <AK/HashMap.h>
#include <AK/String.h>
2020-10-11 17:57:43 +00:00
#include <AK/StringBuilder.h>
namespace AK {
class SourceGenerator {
AK_MAKE_NONCOPYABLE(SourceGenerator);
2020-10-11 17:57:43 +00:00
public:
using MappingType = HashMap<StringView, String>;
2020-10-11 17:57:43 +00:00
explicit SourceGenerator(StringBuilder& builder, char opening = '@', char closing = '@')
: m_builder(builder)
2020-10-11 17:57:43 +00:00
, m_opening(opening)
, m_closing(closing)
{
}
explicit SourceGenerator(StringBuilder& builder, MappingType&& mapping, char opening = '@', char closing = '@')
: m_builder(builder)
, m_mapping(move(mapping))
2020-10-11 17:57:43 +00:00
, m_opening(opening)
, m_closing(closing)
{
}
SourceGenerator(SourceGenerator&&) = default;
// Move-assign is undefinable due to 'StringBuilder& m_builder;'
SourceGenerator& operator=(SourceGenerator&&) = delete;
[[nodiscard]] SourceGenerator fork()
{
return SourceGenerator { m_builder, MUST(m_mapping.clone()), m_opening, m_closing };
}
2020-10-11 17:57:43 +00:00
void set(StringView key, String value)
{
if (key.contains(m_opening) || key.contains(m_closing)) {
warnln("SourceGenerator keys cannot contain the opening/closing delimiters `{}` and `{}`. (Keys are only wrapped in these when using them, not when setting them.)", m_opening, m_closing);
VERIFY_NOT_REACHED();
}
m_mapping.set(key, move(value));
}
String get(StringView key) const
{
auto result = m_mapping.get(key);
if (!result.has_value()) {
warnln("No key named `{}` set on SourceGenerator", key);
VERIFY_NOT_REACHED();
}
return result.release_value();
}
2020-10-11 17:57:43 +00:00
StringView as_string_view() const { return m_builder.string_view(); }
2020-10-11 17:57:43 +00:00
void append(StringView pattern)
2020-10-11 17:57:43 +00:00
{
GenericLexer lexer { pattern };
while (!lexer.is_eof()) {
m_builder.append(lexer.consume_until(m_opening));
2020-10-11 17:57:43 +00:00
if (lexer.consume_specific(m_opening)) {
auto const placeholder = lexer.consume_until(m_closing);
2020-10-11 17:57:43 +00:00
if (!lexer.consume_specific(m_closing))
VERIFY_NOT_REACHED();
2020-10-11 17:57:43 +00:00
m_builder.append(get(placeholder));
2020-10-11 17:57:43 +00:00
} else {
VERIFY(lexer.is_eof());
2020-10-11 17:57:43 +00:00
}
}
}
void appendln(StringView pattern)
{
append(pattern);
m_builder.append('\n');
}
template<size_t N>
String get(char const (&key)[N])
{
return get(StringView { key, N - 1 });
}
template<size_t N>
void set(char const (&key)[N], String value)
{
set(StringView { key, N - 1 }, value);
}
template<size_t N>
void append(char const (&pattern)[N])
{
append(StringView { pattern, N - 1 });
}
template<size_t N>
void appendln(char const (&pattern)[N])
{
appendln(StringView { pattern, N - 1 });
}
// FIXME: These are deprecated.
void set(StringView key, DeprecatedString value)
{
set(key, MUST(String::from_deprecated_string(value)));
}
template<size_t N>
void set(char const (&key)[N], DeprecatedString value)
{
set(StringView { key, N - 1 }, value);
}
2020-10-11 17:57:43 +00:00
private:
StringBuilder& m_builder;
2020-10-11 17:57:43 +00:00
MappingType m_mapping;
char m_opening, m_closing;
};
}
#if USING_AK_GLOBALLY
2020-10-11 17:57:43 +00:00
using AK::SourceGenerator;
#endif