ladybird/AK/SourceGenerator.h

158 lines
4.3 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>
* Copyright (c) 2024, Tim Ledbetter <timledbetter@gmail.com>
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/ByteString.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 = '@', char escape = '\\')
: m_builder(builder)
2020-10-11 17:57:43 +00:00
, m_opening(opening)
, m_closing(closing)
, m_escape(escape)
2020-10-11 17:57:43 +00:00
{
}
explicit SourceGenerator(StringBuilder& builder, MappingType&& mapping, char opening = '@', char closing = '@', char escape = '\\')
: m_builder(builder)
, m_mapping(move(mapping))
2020-10-11 17:57:43 +00:00
, m_opening(opening)
, m_closing(closing)
, m_escape(escape)
2020-10-11 17:57:43 +00:00
{
}
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([&](char ch) { return ch == m_opening || ch == m_escape; }));
if (lexer.consume_specific(m_escape)) {
if (!(lexer.next_is(m_opening) || lexer.next_is(m_escape))) {
if (lexer.is_eof())
warnln("Unexpected EOF while parsing escape sequence on SourceGenerator");
else
warnln("Invalid escape sequence found `{}{}` on SourceGenerator", m_escape, lexer.peek());
VERIFY_NOT_REACHED();
}
m_builder.append(lexer.consume());
continue;
}
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, ByteString value)
{
set(key, MUST(String::from_byte_string(value)));
}
template<size_t N>
void set(char const (&key)[N], ByteString 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 { '@' };
char m_closing { '@' };
char m_escape { '\\' };
2020-10-11 17:57:43 +00:00
};
}
#if USING_AK_GLOBALLY
2020-10-11 17:57:43 +00:00
using AK::SourceGenerator;
#endif