1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
//===--- SwiftInterfaceGenContext.h - ---------------------------*- C++ -*-===//
//
// 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
//
//===----------------------------------------------------------------------===//
#ifndef LLVM_SOURCEKIT_LIB_SWIFTLANG_SWIFTINTERFACEGENCONTEXT_H
#define LLVM_SOURCEKIT_LIB_SWIFTLANG_SWIFTINTERFACEGENCONTEXT_H
#include "SourceKit/Core/LLVM.h"
#include "swift/AST/Module.h"
#include "swift/Basic/ThreadSafeRefCounted.h"
#include <string>
namespace swift {
class CompilerInvocation;
class ValueDecl;
class ModuleDecl;
}
namespace SourceKit {
class EditorConsumer;
class SwiftInterfaceGenContext;
typedef RefPtr<SwiftInterfaceGenContext> SwiftInterfaceGenContextRef;
class ASTUnit;
typedef IntrusiveRefCntPtr<ASTUnit> ASTUnitRef;
class SwiftInterfaceGenContext :
public llvm::ThreadSafeRefCountedBase<SwiftInterfaceGenContext> {
public:
static SwiftInterfaceGenContextRef
create(StringRef DocumentName, bool IsModule, StringRef ModuleOrHeaderName,
std::optional<StringRef> Group, swift::CompilerInvocation Invocation,
std::string &ErrorMsg, bool SynthesizedExtensions,
std::optional<StringRef> InterestedUSR);
static SwiftInterfaceGenContextRef
createForTypeInterface(swift::CompilerInvocation Invocation,
StringRef TypeUSR,
std::string &ErrorMsg);
static SwiftInterfaceGenContextRef createForSwiftSource(StringRef DocumentName,
StringRef SourceFileName,
ASTUnitRef AstUnit,
swift::CompilerInvocation Invocation,
std::string &ErrMsg);
~SwiftInterfaceGenContext();
StringRef getDocumentName() const;
StringRef getModuleOrHeaderName() const;
bool isModule() const;
swift::ModuleDecl *getModuleDecl() const;
bool matches(StringRef ModuleName, const swift::CompilerInvocation &Invok);
/// Note: requires exclusive access to the underlying AST.
void reportEditorInfo(EditorConsumer &Consumer) const;
struct ResolvedEntity {
const swift::ValueDecl *Dcl = nullptr;
swift::ModuleEntity Mod;
bool IsRef = false;
ResolvedEntity() = default;
ResolvedEntity(const swift::ValueDecl *Dcl, bool IsRef)
: Dcl(Dcl), IsRef(IsRef) {}
ResolvedEntity(const swift::ModuleEntity Mod, bool IsRef)
: Mod(Mod), IsRef(IsRef) {}
bool isResolved() const { return Dcl || Mod; }
};
/// Provides exclusive access to the underlying AST.
void accessASTAsync(std::function<void()> Fn);
/// Returns the resolved entity along with a boolean indicating if it is a
/// reference or not.
/// Note: requires exclusive access to the underlying AST. See accessASTAsync.
ResolvedEntity resolveEntityForOffset(unsigned Offset) const;
/// Searches for a declaration with the given USR and returns the
/// (offset,length) pair into the interface source if it finds one.
std::optional<std::pair<unsigned, unsigned>>
findUSRRange(StringRef USR) const;
void applyTo(swift::CompilerInvocation &CompInvok) const;
class Implementation;
private:
Implementation &Impl;
SwiftInterfaceGenContext();
};
} // namespace SourceKit
#endif
|
