class_diagram_generator.cc

Go to the documentation of this file.

/**
 * @file src/class_diagram/generators/plantuml/class_diagram_generator.cc
 *
 * Copyright (c) 2021-2025 Bartek Kryza <bkryza@gmail.com>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#include "class_diagram_generator.h"
 
#include "util/error.h"
 
#include <inja/inja.hpp>
 
namespace clanguml::class_diagram::generators::plantuml {
 
using clanguml::common::generators::display_name_adapter;
 
generator::generator(diagram_config &config, diagram_model &model)
    : common_generator<diagram_config, diagram_model>{config, model}
    , class_diagram::generators::text_diagram_strategy<generator>{
          *this, config.generate_packages()}
{
}
 
void generator::generate_link(
    std::ostream &ostr, const class_diagram::model::class_element &e) const
{
    if (e.file_relative().empty())
        return;
 
    auto maybe_link_pattern = get_link_pattern(e);
    if (maybe_link_pattern) {
        const auto &[link_prefix, link_pattern] = *maybe_link_pattern;
        inja::json context = common::jinja::element_context<class_element>(
            e, common_generator<diagram_config, diagram_model>::context());
 
        common::generators::make_context_source_relative(context, link_prefix);
 
        ostr << " [[[";
        ostr << common::jinja::render_template(env(), context, link_pattern)
                    .value_or("");
    }
 
    auto maybe_tooltip_pattern = get_tooltip_pattern(e);
 
    if (maybe_tooltip_pattern) {
        const auto &[tooltip_prefix, tooltip_pattern] = *maybe_tooltip_pattern;
        inja::json context = common::jinja::element_context<class_element>(
            e, common_generator<diagram_config, diagram_model>::context());
        common::generators::make_context_source_relative(
            context, tooltip_prefix);
        ostr << "{";
        ostr << common::jinja::render_template(env(), context, tooltip_pattern)
                    .value_or("");
        ostr << "}";
    }
    ostr << "]]]";
}
 
void generator::generate_alias(const class_ &c, std::ostream &ostr) const
{
    std::string class_type{"class"};
    if (c.is_abstract())
        class_type = "abstract";
 
    std::string full_name;
    if (!config().generate_fully_qualified_name())
        full_name = display_name_adapter(c).with_packages().full_name_no_ns();
    else
        full_name = display_name_adapter(c).full_name(true);
 
    assert(!full_name.empty());
 
    print_debug(c, ostr);
 
    auto fn = config().simplify_template_type(full_name);
 
    // PlantUML doesn't render empty template properly unless there's at least
    // one character inside
    if (util::ends_with(fn, std::string{"<>"})) {
        fn = fn.substr(0, fn.size() - 2) + "< >";
    }
 
    ostr << class_type << " \"" << fn;
 
    ostr << "\" as " << c.alias() << '\n';
 
    // Register the added alias
    m_generated_aliases.emplace(c.alias());
}
 
void generator::generate_alias(const enum_ &e, std::ostream &ostr) const
{
    print_debug(e, ostr);
 
    if (!config().generate_fully_qualified_name())
        ostr << "enum" << " \"" << display_name_adapter(e).name();
    else
        ostr << "enum" << " \"" << display_name_adapter(e).full_name(true);
 
    ostr << "\" as " << e.alias() << '\n';
 
    // Register the added alias
    m_generated_aliases.emplace(e.alias());
}
 
void generator::generate_alias(const concept_ &c, std::ostream &ostr) const
{
    print_debug(c, ostr);
 
    if (!config().generate_fully_qualified_name())
        ostr << "class" << " \"" << c.full_name_no_ns();
    else
        ostr << "class" << " \"" << display_name_adapter(c).full_name(true);
 
    ostr << "\" as " << c.alias() << '\n';
 
    // Register the added alias
    m_generated_aliases.emplace(c.alias());
}
 
void generator::generate_alias(
    const objc_interface &e, std::ostream &ostr) const
{
    print_debug(e, ostr);
 
    if (!e.is_protocol())
        ostr << "class";
    else
        ostr << "protocol";
 
    ostr << " \"" << display_name_adapter(e).full_name(true);
 
    ostr << "\" as " << e.alias() << '\n';
 
    // Register the added alias
    m_generated_aliases.emplace(e.alias());
}
 
void generator::generate(const class_ &c, std::ostream &ostr) const
{
    std::string class_type{"class"};
    if (c.is_abstract())
        class_type = "abstract";
 
    ostr << class_type << " " << c.alias();
 
    if (c.is_union())
        ostr << " " << "<<union>>";
 
    if (config().generate_links) {
        common_generator<diagram_config, diagram_model>::generate_link(ostr, c);
    }
 
    generate_style(ostr, c.type_name(), c);
 
    ostr << " {" << '\n';
 
    //
    // Process methods
    //
    if (config().group_methods()) {
        generate_method_groups(group_methods(c.methods()), ostr);
    }
    else {
        generate_methods(c.methods(), ostr);
    }
 
    //
    // Process relationships - here only generate the set of
    // rendered_relationships we'll generate them in a seperate method
    //
    std::set<std::string> rendered_relations;
 
    std::stringstream all_relations_str;
    for (const auto &r : c.relationships()) {
        try {
            generate_relationship(r, rendered_relations);
        }
        catch (error::uml_alias_missing &e) {
            LOG_DBG("Skipping {} relation from {} to {} due "
                    "to: {}",
                to_string(r.type()), c.full_name(true), r.destination(),
                e.what());
        }
    }
 
    //
    // Process members
    //
    std::vector<clanguml::class_diagram::model::class_member> members{
        c.members()};
 
    sort_class_elements(members);
 
    if (config().group_methods())
        ostr << "__\n";
 
    for (const auto &m : members) {
        if (!config().include_relations_also_as_members() &&
            rendered_relations.find(m.name()) != rendered_relations.end())
            continue;
 
        generate_member(m, ostr);
 
        ostr << '\n';
    }
 
    ostr << "}" << '\n';
 
    generate_notes(ostr, c);
 
    for (const auto &member : c.members())
        generate_member_notes(ostr, member, c.alias());
 
    for (const auto &method : c.methods())
        generate_member_notes(ostr, method, c.alias());
}
 
void generator::start_method_group(std::ostream &ostr) const { ostr << "..\n"; }
 
void generator::generate_methods(
    const std::vector<class_method> &methods, std::ostream &ostr) const
{
    auto sorted_methods = methods;
    sort_class_elements(sorted_methods);
 
    for (const auto &m : sorted_methods) {
        generate_method(m, ostr);
        ostr << '\n';
    }
}
 
void generator::generate_methods(
    const std::vector<objc_method> &methods, std::ostream &ostr) const
{
    auto sorted_methods = methods;
    sort_class_elements(sorted_methods);
 
    for (const auto &m : sorted_methods) {
        generate_method(m, ostr);
        ostr << '\n';
    }
}
 
void generator::generate_method(
    const class_diagram::model::class_method &m, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
    const auto &uns = config().using_namespace();
 
    constexpr auto kAbbreviatedMethodArgumentsLength{15};
 
    print_debug(m, ostr);
 
    if (m.is_pure_virtual())
        ostr << "{abstract} ";
 
    if (m.is_static())
        ostr << "{static} ";
 
    std::string type{uns.relative(config().simplify_template_type(m.type()))};
 
    ostr << plantuml_common::to_plantuml(m.access()) << m.name();
 
    if (!m.template_params().empty()) {
        m.render_template_params(ostr, config().using_namespace(), false);
    }
 
    ostr << "(";
    if (config().generate_method_arguments() !=
        config::method_arguments::none) {
        std::vector<std::string> params;
        std::transform(m.parameters().cbegin(), m.parameters().cend(),
            std::back_inserter(params), [this](const auto &mp) {
                return config().simplify_template_type(
                    mp.to_string(config().using_namespace()));
            });
        auto args_string = fmt::format("{}", fmt::join(params, ", "));
        if (config().generate_method_arguments() ==
            config::method_arguments::abbreviated) {
            args_string = clanguml::util::abbreviate(
                args_string, kAbbreviatedMethodArgumentsLength);
        }
        ostr << args_string;
    }
    ostr << ")";
 
    if (m.is_constexpr())
        ostr << " constexpr";
    else if (m.is_consteval())
        ostr << " consteval";
 
    if (m.is_const())
        ostr << " const";
 
    if (m.is_noexcept())
        ostr << " noexcept";
 
    assert(!(m.is_pure_virtual() && m.is_defaulted()));
 
    if (m.is_pure_virtual())
        ostr << " = 0";
 
    if (m.is_defaulted())
        ostr << " = default";
    else if (m.is_deleted())
        ostr << " = deleted";
 
    if (m.is_coroutine())
        ostr << " [coroutine]";
 
    ostr << " : " << type;
 
    if (config().generate_links) {
        generate_link(ostr, m);
    }
}
 
void generator::generate_member(
    const class_diagram::model::class_member &m, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
    const auto &uns = config().using_namespace();
 
    print_debug(m, ostr);
 
    if (m.is_static())
        ostr << "{static} ";
 
    ostr << plantuml_common::to_plantuml(m.access())
         << display_name_adapter(m).name() << " : "
         << uns.relative(config().simplify_template_type(
                display_name_adapter(m).type()));
 
    if (config().generate_links) {
        generate_link(ostr, m);
    }
}
 
void generator::generate(const concept_ &c, std::ostream &ostr) const
{
    std::string class_type{"class"};
 
    ostr << class_type << " " << c.alias() << " <<concept>>";
 
    if (config().generate_links) {
        common_generator<diagram_config, diagram_model>::generate_link(ostr, c);
    }
 
    generate_style(ostr, c.type_name(), c);
 
    ostr << " {" << '\n';
 
    if (config().generate_concept_requirements() &&
        (c.requires_parameters().size() + c.requires_statements().size() > 0)) {
        std::vector<std::string> parameters;
        parameters.reserve(c.requires_parameters().size());
        for (const auto &p : c.requires_parameters()) {
            parameters.emplace_back(p.to_string(config().using_namespace()));
        }
 
        ostr << fmt::format("({})\n", fmt::join(parameters, ","));
 
        ostr << "..\n";
 
        ostr << fmt::format("{}\n", fmt::join(c.requires_statements(), "\n"));
    }
 
    ostr << "}" << '\n';
}
 
void generator::generate(const objc_interface &c, std::ostream &ostr) const
{
    std::string class_type{"class"};
    if (c.is_protocol())
        class_type = "protocol";
 
    ostr << class_type << " " << c.alias();
 
    ostr << " ";
    if (c.is_protocol())
        ostr << "<<ObjC Protocol>>";
    else if (c.is_category())
        ostr << "<<ObjC Category>>";
    else
        ostr << "<<ObjC Interface>>";
 
    if (config().generate_links) {
        common_generator<diagram_config, diagram_model>::generate_link(ostr, c);
    }
 
    generate_style(ostr, c.type_name(), c);
 
    ostr << " {" << '\n';
 
    //
    // Process methods
    //
    generate_methods(c.methods(), ostr);
 
    //
    // Process relationships - here only generate the set of
    // rendered_relationships we'll generate them in a seperate method
    //
    std::set<std::string> rendered_relations;
 
    std::stringstream all_relations_str;
    for (const auto &r : c.relationships()) {
        try {
            generate_relationship(r, rendered_relations);
        }
        catch (error::uml_alias_missing &e) {
            LOG_DBG("Skipping {} relation from {} to {} due "
                    "to: {}",
                to_string(r.type()), c.full_name(true), r.destination(),
                e.what());
        }
    }
 
    //
    // Process members
    //
    std::vector<clanguml::class_diagram::model::objc_member> members{
        c.members()};
 
    sort_class_elements(members);
 
    if (config().group_methods())
        ostr << "__\n";
 
    for (const auto &m : members) {
        if (!config().include_relations_also_as_members() &&
            rendered_relations.find(m.name()) != rendered_relations.end())
            continue;
 
        generate_member(m, ostr);
 
        ostr << '\n';
    }
 
    ostr << "}" << '\n';
 
    generate_notes(ostr, c);
 
    for (const auto &member : c.members())
        generate_member_notes(ostr, member, c.alias());
 
    for (const auto &method : c.methods())
        generate_member_notes(ostr, method, c.alias());
}
 
void generator::generate_method(
    const class_diagram::model::objc_method &m, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
    const auto &uns = config().using_namespace();
 
    constexpr auto kAbbreviatedMethodArgumentsLength{15};
 
    print_debug(m, ostr);
 
    if (m.is_static())
        ostr << "{static} ";
 
    std::string type{uns.relative(config().simplify_template_type(m.type()))};
 
    ostr << plantuml_common::to_plantuml(m.access()) << m.name();
 
    ostr << "(";
    if (config().generate_method_arguments() !=
        config::method_arguments::none) {
        std::vector<std::string> params;
        std::transform(m.parameters().cbegin(), m.parameters().cend(),
            std::back_inserter(params), [this](const auto &mp) {
                return config().simplify_template_type(
                    mp.to_string(config().using_namespace()));
            });
        auto args_string = fmt::format("{}", fmt::join(params, ", "));
        if (config().generate_method_arguments() ==
            config::method_arguments::abbreviated) {
            args_string = clanguml::util::abbreviate(
                args_string, kAbbreviatedMethodArgumentsLength);
        }
        ostr << args_string;
    }
    ostr << ")";
 
    ostr << " : " << type;
 
    if (config().generate_links) {
        generate_link(ostr, m);
    }
}
 
void generator::generate_member(
    const class_diagram::model::objc_member &m, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
    const auto &uns = config().using_namespace();
 
    print_debug(m, ostr);
 
    if (m.is_static())
        ostr << "{static} ";
 
    ostr << plantuml_common::to_plantuml(m.access())
         << display_name_adapter(m).name() << " : "
         << uns.relative(config().simplify_template_type(
                display_name_adapter(m).type()));
 
    if (config().generate_links) {
        generate_link(ostr, m);
    }
}
 
void generator::generate_member_notes(std::ostream &ostr,
    const class_element &member, const std::string &alias) const
{
    for (const auto &decorator : member.decorators()) {
        auto note = std::dynamic_pointer_cast<decorators::note>(decorator);
        if (note && note->applies_to_diagram(config().name)) {
            ostr << "note " << note->position << " of " << alias
                 << "::" << member.name() << '\n'
                 << note->text << '\n'
                 << "end note\n";
        }
    }
}
 
void generator::generate_relationship(
    const relationship &r, std::set<std::string> &rendered_relations) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
 
    LOG_DBG("Processing relationship {}", to_string(r.type()));
 
    std::string destination;
 
    auto target_element = model().get(r.destination());
    if (!target_element.has_value())
        throw error::uml_alias_missing{fmt::format(
            "Missing element in the model for ID: {}", r.destination())};
 
    destination = target_element.value().full_name(false);
 
    if (util::starts_with(destination, std::string{"::"}))
        destination = destination.substr(2, destination.size());
 
    std::string puml_relation;
    if (!r.multiplicity_source().empty())
        puml_relation += "\"" + r.multiplicity_source() + "\" ";
 
    puml_relation += plantuml_common::to_plantuml(r, config());
 
    if (!r.multiplicity_destination().empty())
        puml_relation += " \"" + r.multiplicity_destination() + "\"";
 
    if (!r.label().empty()) {
        rendered_relations.emplace(r.label());
    }
}
 
void generator::generate_relationships(
    const class_ &c, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
 
    //
    // Process relationships
    //
    std::set<std::string> rendered_relations;
 
    std::stringstream all_relations_str;
    std::set<std::string> unique_relations;
 
    for (const auto &r : c.relationships()) {
        LOG_DBG("== Processing relationship {}",
            plantuml_common::to_plantuml(r, config()));
 
        std::stringstream relstr;
        eid_t destination{};
        try {
            destination = r.destination();
 
            std::string puml_relation;
            if (!r.multiplicity_source().empty())
                puml_relation += "\"" + r.multiplicity_source() + "\" ";
 
            puml_relation += plantuml_common::to_plantuml(r, config());
 
            if (!r.multiplicity_destination().empty())
                puml_relation += " \"" + r.multiplicity_destination() + "\"";
 
            std::string target_alias;
            try {
                target_alias = model().to_alias(destination);
            }
            catch (...) {
                LOG_DBG("Failed to find alias to {}", destination);
                continue;
            }
 
            if (m_generated_aliases.find(target_alias) ==
                m_generated_aliases.end())
                continue;
 
            if (r.type() != relationship_t::kExtension)
                relstr << c.alias() << " " << puml_relation << " "
                       << target_alias;
            else
                relstr << target_alias << " <|-- " << c.alias();
 
            if (config().generate_links) {
                common_generator<diagram_config, diagram_model>::generate_link(
                    relstr, r);
            }
 
            if (!r.label().empty()) {
                relstr << " : " << plantuml_common::to_plantuml(r.access())
                       << r.label();
                rendered_relations.emplace(r.label());
            }
 
            if (unique_relations.count(relstr.str()) == 0) {
                unique_relations.emplace(relstr.str());
 
                LOG_TRACE("=== Adding relation {}", relstr.str());
 
                all_relations_str << relstr.str() << '\n';
            }
        }
        catch (error::uml_alias_missing &e) {
            LOG_DBG("=== Skipping {} relation from {} to {} due "
                    "to: {}",
                to_string(r.type()), c.full_name(true), destination, e.what());
        }
    }
 
    ostr << all_relations_str.str();
}
 
void generator::generate_relationships(
    const concept_ &c, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
 
    //
    // Process relationships
    //
    std::set<std::string> rendered_relations;
 
    std::stringstream all_relations_str;
    std::set<std::string> unique_relations;
 
    for (const auto &r : c.relationships()) {
        if (!model().should_include(r.type()))
            continue;
 
        LOG_DBG("== Processing relationship {}", to_string(r.type()));
 
        std::stringstream relstr;
        eid_t destination{};
        try {
            destination = r.destination();
 
            std::string puml_relation;
            if (!r.multiplicity_source().empty())
                puml_relation += "\"" + r.multiplicity_source() + "\" ";
 
            puml_relation += plantuml_common::to_plantuml(r, config());
 
            if (!r.multiplicity_destination().empty())
                puml_relation += " \"" + r.multiplicity_destination() + "\"";
 
            std::string target_alias;
            try {
                target_alias = model().to_alias(destination);
            }
            catch (...) {
                LOG_DBG("Failed to find alias to {}", destination);
                continue;
            }
 
            if (m_generated_aliases.find(target_alias) ==
                m_generated_aliases.end())
                continue;
 
            relstr << c.alias() << " " << puml_relation << " " << target_alias;
 
            if (config().generate_links) {
                common_generator<diagram_config, diagram_model>::generate_link(
                    relstr, r);
            }
 
            if (!r.label().empty()) {
                relstr << " : " << plantuml_common::to_plantuml(r.access())
                       << r.label();
                rendered_relations.emplace(r.label());
            }
 
            if (unique_relations.count(relstr.str()) == 0) {
                unique_relations.emplace(relstr.str());
 
                LOG_TRACE("=== Adding relation {}", relstr.str());
 
                all_relations_str << relstr.str() << '\n';
            }
        }
        catch (error::uml_alias_missing &e) {
            LOG_DBG("=== Skipping {} relation from {} to {} due "
                    "to: {}",
                to_string(r.type()), c.full_name(true), destination, e.what());
        }
    }
 
    ostr << all_relations_str.str();
}
 
void generator::generate(const enum_ &e, std::ostream &ostr) const
{
    ostr << "enum " << e.alias();
 
    if (config().generate_links) {
        common_generator<diagram_config, diagram_model>::generate_link(ostr, e);
    }
 
    generate_style(ostr, e.type_name(), e);
 
    ostr << " {" << '\n';
 
    for (const auto &enum_constant : e.constants()) {
        ostr << enum_constant << '\n';
    }
 
    ostr << "}" << '\n';
 
    generate_notes(ostr, e);
}
 
void generator::generate_relationships(const enum_ &e, std::ostream &ostr) const
{
    for (const auto &r : e.relationships()) {
        eid_t destination{};
        std::stringstream relstr;
        try {
            destination = r.destination();
 
            auto target_alias = model().to_alias(destination);
 
            if (m_generated_aliases.find(target_alias) ==
                m_generated_aliases.end())
                continue;
 
            relstr << e.alias() << " "
                   << clanguml::common::generators::plantuml::to_plantuml(
                          r, config())
                   << " " << target_alias;
 
            if (config().generate_links) {
                common_generator<diagram_config, diagram_model>::generate_link(
                    relstr, r);
            }
 
            if (!r.label().empty())
                relstr << " : " << r.label();
 
            relstr << '\n';
 
            ostr << relstr.str();
        }
        catch (error::uml_alias_missing &ex) {
            LOG_DBG("Skipping {} relation from {} to {} due "
                    "to: {}",
                clanguml::common::generators::plantuml::to_plantuml(
                    r, config()),
                e.full_name(true), destination, ex.what());
        }
    }
}
 
void generator::generate_relationships(
    const objc_interface &c, std::ostream &ostr) const
{
    namespace plantuml_common = clanguml::common::generators::plantuml;
 
    //
    // Process relationships
    //
    std::set<std::string> rendered_relations;
 
    std::stringstream all_relations_str;
    std::set<std::string> unique_relations;
 
    for (const auto &r : c.relationships()) {
        LOG_DBG("== Processing relationship {}",
            plantuml_common::to_plantuml(r, config()));
 
        std::stringstream relstr;
        eid_t destination{};
        try {
            destination = r.destination();
 
            std::string puml_relation;
            if (!r.multiplicity_source().empty())
                puml_relation += "\"" + r.multiplicity_source() + "\" ";
 
            puml_relation += plantuml_common::to_plantuml(r, config());
 
            if (!r.multiplicity_destination().empty())
                puml_relation += " \"" + r.multiplicity_destination() + "\"";
 
            std::string target_alias;
            try {
                target_alias = model().to_alias(destination);
            }
            catch (...) {
                LOG_DBG("Failed to find alias to {}", destination);
                continue;
            }
 
            if (m_generated_aliases.find(target_alias) ==
                m_generated_aliases.end())
                continue;
 
            if (r.type() != relationship_t::kExtension)
                relstr << c.alias() << " " << puml_relation << " "
                       << target_alias;
            else
                relstr << target_alias << " <|-- " << c.alias();
 
            if (config().generate_links) {
                common_generator<diagram_config, diagram_model>::generate_link(
                    relstr, r);
            }
 
            if (!r.label().empty()) {
                relstr << " : " << plantuml_common::to_plantuml(r.access())
                       << r.label();
                rendered_relations.emplace(r.label());
            }
 
            if (unique_relations.count(relstr.str()) == 0) {
                unique_relations.emplace(relstr.str());
 
                LOG_TRACE("=== Adding relation {}", relstr.str());
 
                all_relations_str << relstr.str() << '\n';
            }
        }
        catch (error::uml_alias_missing &e) {
            LOG_DBG("=== Skipping {} relation from {} to {} due "
                    "to: {}",
                to_string(r.type()), c.full_name(true), destination, e.what());
        }
    }
 
    ostr << all_relations_str.str();
}
 
void generator::start_package(const package &p, std::ostream &ostr) const
{
    if (config().generate_packages()) {
        LOG_DBG("Generating package {}",
            display_name_adapter(p).with_packages().name());
 
        print_debug(p, ostr);
        ostr << "package [";
        ostr << display_name_adapter(p).with_packages().name() << "] ";
        ostr << "as " << p.alias();
 
        if (p.is_deprecated())
            ostr << " <<deprecated>>";
 
        generate_style(ostr, p.type_name(), p);
 
        ostr << " {" << '\n';
    }
}
 
void generator::end_package(const package &p, std::ostream &ostr) const
{
    if (config().generate_packages()) {
        ostr << "}" << '\n';
        generate_notes(ostr, p);
    }
}
 
void generator::start_together_group(
    const std::string & /*group_name*/, std::ostream &ostr) const
{
    ostr << "together {\n";
}
 
void generator::end_together_group(
    const std::string & /*group_name*/, std::ostream &ostr) const
{
    ostr << "}\n";
}
 
void generator::generate_diagram(std::ostream &ostr) const
{
    generate_top_level_elements(ostr);
 
    generate_groups(ostr);
 
    generate_relationships(ostr);
 
    generate_config_layout_hints(ostr);
}
 
} // namespace clanguml::class_diagram::generators::plantuml