Files
swift-mirror/lib/SymbolGraphGen/DeclarationFragmentPrinter.cpp
Ashley Garland f0887fa245 [SymbolGraph] Emit synthesized members
Emit copies of default implementations in protocol extensions and superclass declarations in conforming types and subclasses respectively using a virtual USR, i.e. `${REAL_USR}::SYNTHESIZED::${CONFORMING_OR_SUBCLASS_TYPE_USR}`.

- Add a -skip-synthesized-members option to skip these synthesized members.

- Create a new wrapping `Symbol` type that can also contain a base type declaration as well as the inherited declaration for those synthesized cases. Move some symbol-specific APIs there.

- Doc comments can “cascade” down to protocol extensions or refinements in concrete types. When emitting the doc comment for a symbol, look up through to superclasses or protocol requirements for where a doc comment is actually written.

- Clean up filtering of implicitly private (e.g. “public underscored”) types

rdar://problem/59128787
2020-03-04 16:04:21 -08:00

145 lines
3.9 KiB
C++

//===--- DeclarationFragmentPrinter.cpp - Declaration Fragment Printer ----===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2017 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
#include "swift/AST/USRGeneration.h"
#include "DeclarationFragmentPrinter.h"
#include "SymbolGraphASTWalker.h"
using namespace swift;
using namespace symbolgraphgen;
void DeclarationFragmentPrinter::openFragment(FragmentKind Kind) {
assert(Kind != FragmentKind::None);
if (this->Kind != Kind) {
closeFragment();
this->Kind = Kind,
Spelling.clear();
USR.clear();
}
}
StringRef
DeclarationFragmentPrinter::getKindSpelling(FragmentKind Kind) const {
switch (Kind) {
case FragmentKind::Keyword:
return "keyword";
case FragmentKind::Attribute:
return "attribute";
case FragmentKind::NumberLiteral:
return "number";
case FragmentKind::StringLiteral:
return "string";
case FragmentKind::Identifier:
return "identifier";
case FragmentKind::TypeIdentifier:
return "typeIdentifier";
case FragmentKind::GenericParameter:
return "genericParameter";
case FragmentKind::Text:
return "text";
case FragmentKind::None:
llvm_unreachable("Fragment kind of 'None' has no spelling");
}
}
void DeclarationFragmentPrinter::closeFragment() {
if (Kind == FragmentKind::None) {
return;
}
++NumFragments;
if (!Spelling.empty()) {
OS.object([&](){
OS.attribute("kind", getKindSpelling(Kind));
OS.attribute("spelling", Spelling.str());
if (!USR.empty()) {
OS.attribute("preciseIdentifier", USR.str());
}
});
}
Spelling.clear();
USR.clear();
Kind = FragmentKind::None;
}
void DeclarationFragmentPrinter::printDeclLoc(const Decl *D) {
switch (D->getKind()) {
case DeclKind::Constructor:
case DeclKind::Destructor:
case DeclKind::Subscript:
openFragment(FragmentKind::Keyword);
break;
default:
openFragment(FragmentKind::Identifier);
break;
}
}
void
DeclarationFragmentPrinter::printNamePre(PrintNameContext Context) {
switch (Context) {
case PrintNameContext::Keyword:
openFragment(FragmentKind::Keyword);
break;
case PrintNameContext::GenericParameter:
openFragment(FragmentKind::GenericParameter);
break;
case PrintNameContext::Attribute:
openFragment(FragmentKind::Attribute);
break;
case PrintNameContext::ClassDynamicSelf:
case PrintNameContext::FunctionParameterExternal:
openFragment(FragmentKind::Identifier);
break;
case PrintNameContext::FunctionParameterLocal:
openFragment(FragmentKind::Identifier);
break;
case PrintNameContext::TupleElement:
case PrintNameContext::TypeMember:
case PrintNameContext::Normal:
break;
}
}
void DeclarationFragmentPrinter::printStructurePre(PrintStructureKind Kind,
const Decl *D) {
switch (Kind) {
case PrintStructureKind::NumberLiteral:
openFragment(FragmentKind::NumberLiteral);
break;
case PrintStructureKind::StringLiteral:
openFragment(FragmentKind::StringLiteral);
break;
default:
break;
}
}
void DeclarationFragmentPrinter::printTypeRef(Type T, const TypeDecl *RefTo,
Identifier Name,
PrintNameContext NameContext) {
openFragment(FragmentKind::TypeIdentifier);
printText(Name.str());
llvm::raw_svector_ostream OS(USR);
ide::printDeclUSR(RefTo, OS);
closeFragment();
}
void DeclarationFragmentPrinter::printText(StringRef Text) {
if (Kind == FragmentKind::None) {
openFragment(FragmentKind::Text);
}
Spelling.append(Text);
}