Files
swift-mirror/include/swift/Parse/CodeCompletionCallbacks.h
Dmitri Hrybenko cdb1df51a3 Code completion: completion of type-ident in type contexts (like Foo.#^A^#)
This introduces the required code completion callbacks which pass partially
parsed TypeReprs to code completion.  These types can refer to generic function
parameters.  Because we need to typecheck these types, we need to typecheck
generic parameters first.  Because exposing fine-grained typechecker interface
just for code completion is bad, we create a function declaration based on the
limited information we have (i.e., just the function name and generic
parameters) and pass that to the typechecker.  This approach (in theory) should
work uniformly for function decls and nominal type decls, but the nominal type
decl case is not tested yet.  Eventually we will also want to use a similar
approach for normal parser recovery as well.


Swift SVN r7313
2013-08-17 02:35:32 +00:00

94 lines
3.0 KiB
C++

//===- CodeCompletionCallbacks.h - Parser's interface to code completion --===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2015 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See http://swift.org/LICENSE.txt for license information
// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
#ifndef SWIFT_PARSE_CODE_COMPLETION_CALLBACKS_H
#define SWIFT_PARSE_CODE_COMPLETION_CALLBACKS_H
#include "swift/AST/ASTContext.h"
#include "swift/Parse/Parser.h"
namespace swift {
/// \brief Parser's interface to code completion.
class CodeCompletionCallbacks {
protected:
Parser &P;
ASTContext &Context;
Parser::ParserPosition ExprBeginPosition;
/// The declaration parsed during delayed parsing that was caused by code
/// completion. This declaration contained the code completion token.
Decl *DelayedParsedDecl = nullptr;
public:
CodeCompletionCallbacks(Parser &P)
: P(P), Context(P.Context) {
}
virtual ~CodeCompletionCallbacks() {}
void setExprBeginning(Parser::ParserPosition PP) {
ExprBeginPosition = PP;
}
void setDelayedParsedDecl(Decl *D) {
DelayedParsedDecl = D;
}
/// \brief Complete the whole expression. This is a fallback that should
/// produce results when more specific completion methods failed.
virtual void completeExpr() = 0;
/// \brief Complete expr-dot after we have consumed the dot.
virtual void completeDotExpr(Expr *E) = 0;
/// \brief Complete the beginning of expr-postfix -- no tokens provided
/// by user.
virtual void completePostfixExprBeginning() = 0;
/// \brief Complete a given expr-postfix.
virtual void completePostfixExpr(Expr *E) = 0;
/// \brief Complete expr-super after we have consumed the 'super' keyword.
virtual void completeExprSuper(SuperRefExpr *SRE) = 0;
/// \brief Complete expr-super after we have consumed the 'super' keyword and
/// a dot.
virtual void completeExprSuperDot(SuperRefExpr *SRE) = 0;
/// \brief Complete the beginning of type-simple -- no tokens provided
/// by user.
virtual void completeTypeSimpleBeginning() = 0;
/// \brief Complete a given type-identifier after we have consumed the dot.
virtual void completeTypeIdentifier(IdentTypeRepr *ITR) = 0;
/// \brief Signals that the AST for the all the delayed-parsed code was
/// constructed. No \c complete*() callbacks will be done after this.
virtual void doneParsing() = 0;
};
/// \brief A factory to create instances of \c CodeCompletionCallbacks.
class CodeCompletionCallbacksFactory {
public:
virtual ~CodeCompletionCallbacksFactory() {}
/// \brief Create an instance of \c CodeCompletionCallbacks. The result
/// should be deallocated with 'delete'.
virtual CodeCompletionCallbacks *createCodeCompletionCallbacks(Parser &P) = 0;
};
} // namespace swift
#endif // LLVM_SWIFT_PARSE_CODE_COMPLETION_CALLBACKS_H