Added support for class friend declarations

This commit is contained in:
Bartek Kryza
2021-03-11 18:05:16 +01:00
parent 47dc82931f
commit 3bdac248ba
9 changed files with 153 additions and 5 deletions

View File

@@ -126,6 +126,8 @@ public:
return to_string(clang_getCursorKindSpelling(m_cursor.kind));
}
cursor definition() const { return clang_getCursorDefinition(m_cursor); }
bool is_definition() const { return clang_isCursorDefinition(m_cursor); }
bool is_declaration() const { return clang_isDeclaration(kind()); }

View File

@@ -90,12 +90,14 @@ public:
return "-->";
case relationship_t::kInstantiation:
return "..|>";
case relationship_t::kFriendship:
return "<..";
default:
return "";
}
}
void generate(const class_ &c, std::ostream &ostr) const
void generate_aliases(const class_ &c, std::ostream &ostr) const
{
std::string class_type{"class"};
if (c.is_abstract())
@@ -104,6 +106,13 @@ public:
ostr << class_type << " \"" << c.full_name(m_config.using_namespace);
ostr << "\" as " << c.alias() << std::endl;
}
void 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() << " {" << std::endl;
@@ -166,7 +175,8 @@ public:
destination = m_model.usr_to_name(
m_config.using_namespace, r.destination);
}
else if (r.destination.find("#") != std::string::npos) {
else if (r.destination.find("#") != std::string::npos ||
r.destination.find("@") != std::string::npos) {
destination = m_model.usr_to_name(
m_config.using_namespace, r.destination);
}
@@ -204,6 +214,11 @@ public:
{
ostr << "@startuml" << std::endl;
for (const auto &c : m_model.classes) {
generate_aliases(c, ostr);
ostr << std::endl;
}
for (const auto &c : m_model.classes) {
generate(c, ostr);
ostr << std::endl;

View File

@@ -44,7 +44,8 @@ enum class relationship_t {
kContainment,
kOwnership,
kAssociation,
kInstantiation
kInstantiation,
kFriendship
};
class element {

View File

@@ -201,6 +201,39 @@ static enum CXChildVisitResult enum_visitor(
return ret;
}
static enum CXChildVisitResult friend_class_visitor(
CXCursor cx_cursor, CXCursor cx_parent, CXClientData client_data)
{
auto ctx = (element_visitor_context<class_> *)client_data;
cx::cursor cursor{std::move(cx_cursor)};
cx::cursor parent{std::move(cx_parent)};
spdlog::info("Visiting friend class declaration{}: {} - {}:{}",
ctx->element.name, cursor.spelling(), cursor.kind());
enum CXChildVisitResult ret = CXChildVisit_Break;
switch (cursor.kind()) {
case CXCursor_TypeRef: {
spdlog::info("Adding friend declaration: {}, {}", cursor,
cursor.referenced());
class_relationship r;
r.type = relationship_t::kFriendship;
r.label = "<<friend>>";
r.destination = cursor.referenced().usr();
ctx->element.relationships.emplace_back(std::move(r));
ret = CXChildVisit_Continue;
} break;
default:
ret = CXChildVisit_Continue;
break;
}
return ret;
}
static enum CXChildVisitResult class_visitor(
CXCursor cx_cursor, CXCursor cx_parent, CXClientData client_data)
{
@@ -534,8 +567,12 @@ static enum CXChildVisitResult class_visitor(
ctx->element.bases.emplace_back(std::move(cp));
ret = CXChildVisit_Continue;
break;
}
} break;
case CXCursor_FriendDecl: {
clang_visitChildren(cursor.get(), friend_class_visitor, ctx);
ret = CXChildVisit_Continue;
} break;
default:
ret = CXChildVisit_Continue;
break;

12
tests/t00011/.clanguml Normal file
View File

@@ -0,0 +1,12 @@
compilation_database_dir: ..
output_directory: puml
diagrams:
t00011_class:
type: class
glob:
- ../../tests/t00011/t00011.cc
using_namespace:
- clanguml::t00011
include:
namespaces:
- clanguml::t00011

18
tests/t00011/t00011.cc Normal file
View File

@@ -0,0 +1,18 @@
namespace clanguml {
namespace t00011 {
class B;
class A {
private:
void foo() {}
friend class B;
};
class B {
public:
void foo() { m_a->foo(); }
A *m_a;
};
}
}

54
tests/t00011/test_case.h Normal file
View File

@@ -0,0 +1,54 @@
/**
* tests/t00011/test_case.cc
*
* Copyright (c) 2021 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.
*/
TEST_CASE("Test t00011", "[unit-test]")
{
spdlog::set_level(spdlog::level::debug);
auto [config, db] = load_config("t00011");
auto diagram = config.diagrams["t00011_class"];
REQUIRE(diagram->name == "t00011_class");
REQUIRE(diagram->include.namespaces.size() == 1);
REQUIRE_THAT(diagram->include.namespaces,
VectorContains(std::string{"clanguml::t00011"}));
REQUIRE(diagram->exclude.namespaces.size() == 0);
REQUIRE(diagram->should_include("clanguml::t00011::A"));
REQUIRE(diagram->should_include("clanguml::t00011::B"));
auto model = generate_class_diagram(db, diagram);
REQUIRE(model.name == "t00011_class");
auto puml = generate_class_puml(diagram, model);
AliasMatcher _A(puml);
REQUIRE_THAT(puml, StartsWith("@startuml"));
REQUIRE_THAT(puml, EndsWith("@enduml\n"));
REQUIRE_THAT(puml, IsClass(_A("A")));
REQUIRE_THAT(puml, IsClass(_A("B")));
REQUIRE_THAT(puml, IsFriend(_A("A"), _A("B")));
save_puml(
"./" + config.output_directory + "/" + diagram->name + ".puml", puml);
}

View File

@@ -105,6 +105,7 @@ using clanguml::test::matchers::IsClassTemplate;
using clanguml::test::matchers::IsComposition;
using clanguml::test::matchers::IsEnum;
using clanguml::test::matchers::IsField;
using clanguml::test::matchers::IsFriend;
using clanguml::test::matchers::IsInnerClass;
using clanguml::test::matchers::IsInstantiation;
using clanguml::test::matchers::Private;
@@ -122,3 +123,4 @@ using clanguml::test::matchers::Static;
#include "t00008/test_case.h"
#include "t00009/test_case.h"
#include "t00010/test_case.h"
#include "t00011/test_case.h"

View File

@@ -270,6 +270,13 @@ ContainsMatcher IsAssociation(std::string const &from, std::string const &to,
fmt::format("{} --> {} : {}", from, to, label), caseSensitivity));
}
ContainsMatcher IsFriend(std::string const &from, std::string const &to,
CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes)
{
return ContainsMatcher(CasedString(
fmt::format("{} <.. {} : <<friend>>", from, to), caseSensitivity));
}
ContainsMatcher IsComposition(std::string const &from, std::string const &to,
std::string const &label,
CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes)