mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
7a3a0a9e23
Adds a tool `swift-symbolgraph-extract` that reads an existing Swift module and prints a platform- and language-agnostic JSON description of the module, primarly for documentation. Adds a small sub-library `SymbolGraphGen` which houses the core implementation for collecting relevant information about declarations. The main entry point is integrated directly into the driver as a mode: the tool is meant to be run outside of the normal edit-compile-run/test workflow to avoid impacting build times. Along with common options for other tools, unique options include `pretty-print` for debugging, and a `minimum-access-level` options for including internal documentation. A symbol graph is a directed graph where the nodes are symbols in a module and the edges are relationships between them. For example, a `struct S` may have a member `var x`. The graph would have two nodes for `S` and `x`, and one "member-of" relationship edge. Other relationship kinds include "inherits-from" or "conforms to". The data format for a symbol graph is still under development and may change without notice until a specificiation and versioning scheme is published. Various aspects about a symbol are recorded in the nodes, such as availability, documentation comments, or data needed for printing the shapes of declarations without having to understand specifics about the langauge. Implicit and public-underscored stdlib declarations are not included by default. rdar://problem/55346798
46 lines
1.3 KiB
C++
46 lines
1.3 KiB
C++
//===--- JSON.h - Symbol Graph JSON Helpers -------------------------------===//
|
|
//
|
|
// 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
// Adds Symbol Graph JSON serialization to other types.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_SYMBOLGRAPHGEN_JSON_H
|
|
#define SWIFT_SYMBOLGRAPHGEN_JSON_H
|
|
|
|
#include "llvm/ADT/Triple.h"
|
|
#include "llvm/Support/JSON.h"
|
|
#include "llvm/Support/VersionTuple.h"
|
|
#include "swift/AST/GenericSignature.h"
|
|
|
|
namespace swift {
|
|
namespace symbolgraphgen {
|
|
|
|
struct AttributeRAII {
|
|
StringRef Key;
|
|
llvm::json::OStream &OS;
|
|
AttributeRAII(StringRef Key, llvm::json::OStream &OS)
|
|
: Key(Key), OS(OS) {
|
|
OS.attributeBegin(Key);
|
|
}
|
|
|
|
~AttributeRAII() {
|
|
OS.attributeEnd();
|
|
}
|
|
};
|
|
|
|
void serialize(const llvm::VersionTuple &VT, llvm::json::OStream &OS);
|
|
void serialize(const llvm::Triple &T, llvm::json::OStream &OS);
|
|
|
|
} // end namespace symbolgraphgen
|
|
} // end namespace swift
|
|
|
|
#endif // SWIFT_SYMBOLGRAPHGEN_JSON_H
|