mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
7ee42994c8
Add an option to the lexer to go back and get a list of "full" tokens, which include their leading and trailing trivia, which we can index into from SourceLocs in the current AST. This starts the Syntax sublibrary, which will support structured editing APIs. Some skeleton support and basic implementations are in place for types and generics in the grammar. Yes, it's slightly redundant with what we have right now. lib/AST conflates syntax and semantics in the same place(s); this is a first step in changing that to separate the two concepts for clarity and also to get closer to incremental parsing and type-checking. The goal is to eventually extract all of the syntactic information from lib/AST and change that to be more of a semantic/symbolic model. Stub out a Semantics manager. This ought to eventually be used as a hub for encapsulating lazily computed semantic information for syntax nodes. For the time being, it can serve as a temporary place for mapping from Syntax nodes to semantically full lib/AST nodes. This is still in a molten state - don't get too close, wear appropriate proximity suits, etc.
330 lines
12 KiB
C++
330 lines
12 KiB
C++
//===--- GenericSyntax.cpp - Swift Generic Syntax Implementation *- 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "swift/Syntax/GenericSyntax.h"
|
|
#include "swift/Syntax/RawSyntax.h"
|
|
#include "swift/Syntax/SyntaxFactory.h"
|
|
#include "swift/Syntax/TypeSyntax.h"
|
|
|
|
using llvm::Optional;
|
|
using llvm::None;
|
|
|
|
using namespace swift;
|
|
using namespace swift::syntax;
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-parameter Data
|
|
|
|
GenericParameterSyntaxData::
|
|
GenericParameterSyntaxData(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent)
|
|
: SyntaxData(Raw, Parent, IndexInParent) {}
|
|
|
|
RC<GenericParameterSyntaxData>
|
|
GenericParameterSyntaxData::make(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent) {
|
|
return RC<GenericParameterSyntaxData> {
|
|
new GenericParameterSyntaxData { Raw, Parent, IndexInParent }
|
|
};
|
|
}
|
|
|
|
RC<GenericParameterSyntaxData> GenericParameterSyntaxData::makeBlank() {
|
|
return make(RawSyntax::make(SyntaxKind::GenericParameter,
|
|
{
|
|
TokenSyntax::missingToken(tok::identifier, ""),
|
|
TokenSyntax::missingToken(tok::colon, ":"),
|
|
RawSyntax::missing(SyntaxKind::MissingType),
|
|
},
|
|
SourcePresence::Present));
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-parameter API
|
|
|
|
GenericParameterSyntax::
|
|
GenericParameterSyntax(RC<SyntaxData> Root,
|
|
const GenericParameterSyntaxData *Data)
|
|
: Syntax(Root, Data) {}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-parameter-clause Data
|
|
|
|
GenericParameterClauseSyntaxData::
|
|
GenericParameterClauseSyntaxData(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent)
|
|
: SyntaxData(Raw, Parent, IndexInParent) {
|
|
// TODO: Kind assertions
|
|
}
|
|
|
|
RC<GenericParameterClauseSyntaxData>
|
|
GenericParameterClauseSyntaxData::make(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent) {
|
|
return RC<GenericParameterClauseSyntaxData> {
|
|
new GenericParameterClauseSyntaxData {
|
|
Raw, Parent, IndexInParent,
|
|
}
|
|
};
|
|
}
|
|
|
|
RC<GenericParameterClauseSyntaxData>
|
|
GenericParameterClauseSyntaxData::makeBlank() {
|
|
return make(RawSyntax::make(SyntaxKind::GenericParameterClause,
|
|
{
|
|
TokenSyntax::missingToken(tok::l_angle, "<"),
|
|
RawSyntax::missing(SyntaxKind::GenericParameterList),
|
|
TokenSyntax::missingToken(tok::r_angle, ">"),
|
|
},
|
|
SourcePresence::Present));
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-parameter-clause API
|
|
|
|
GenericParameterClauseSyntax::
|
|
GenericParameterClauseSyntax(RC<SyntaxData> Root,
|
|
const GenericParameterClauseSyntaxData *Data)
|
|
: Syntax(Root, Data) {}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-parameter-clause Builder
|
|
|
|
GenericParameterClauseBuilder::GenericParameterClauseBuilder()
|
|
: LeftAngleToken(TokenSyntax::missingToken(tok::l_angle, "<")),
|
|
ParameterListLayout(RawSyntax::missing(SyntaxKind::GenericParameterList)
|
|
->Layout),
|
|
RightAngleToken(TokenSyntax::missingToken(tok::r_angle, ">")) {}
|
|
|
|
GenericParameterClauseBuilder &GenericParameterClauseBuilder::
|
|
useLeftAngleBracket(RC<TokenSyntax> LeftAngle) {
|
|
syntax_assert_token_is(LeftAngle, tok::l_angle, "<");
|
|
LeftAngleToken = LeftAngle;
|
|
return *this;
|
|
}
|
|
|
|
GenericParameterClauseBuilder &GenericParameterClauseBuilder::
|
|
addParameter(llvm::Optional<RC<TokenSyntax>> MaybeComma,
|
|
GenericParameterSyntax Parameter) {
|
|
if (MaybeComma.hasValue()) {
|
|
syntax_assert_token_is(MaybeComma.getValue(), tok::comma, ",");
|
|
ParameterListLayout.push_back(MaybeComma.getValue());
|
|
} else {
|
|
ParameterListLayout.push_back(TokenSyntax::missingToken(tok::comma, ","));
|
|
}
|
|
ParameterListLayout.push_back(Parameter.getRaw());
|
|
return *this;
|
|
}
|
|
|
|
GenericParameterClauseBuilder &GenericParameterClauseBuilder::
|
|
useRightAngleBracket(RC<TokenSyntax> RightAngle) {
|
|
syntax_assert_token_is(RightAngle, tok::r_angle, ">");
|
|
RightAngleToken = RightAngle;
|
|
return *this;
|
|
}
|
|
|
|
GenericParameterClauseSyntax GenericParameterClauseBuilder::build() const {
|
|
auto ListRaw = RawSyntax::make(SyntaxKind::GenericParameterList,
|
|
ParameterListLayout, SourcePresence::Present);
|
|
auto Raw = RawSyntax::make(SyntaxKind::GenericParameterClause,
|
|
{
|
|
LeftAngleToken,
|
|
ListRaw,
|
|
RightAngleToken,
|
|
},
|
|
SourcePresence::Present);
|
|
auto Data = GenericParameterClauseSyntaxData::make(Raw);
|
|
return { Data, Data.get() };
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-where-clause Data
|
|
|
|
GenericWhereClauseSyntaxData::
|
|
GenericWhereClauseSyntaxData(RC<RawSyntax> Raw, const SyntaxData *Parent,
|
|
CursorIndex IndexInParent)
|
|
: SyntaxData(Raw, Parent, IndexInParent) {
|
|
// TODO: Kind Assertions
|
|
}
|
|
|
|
RC<GenericWhereClauseSyntaxData>
|
|
GenericWhereClauseSyntaxData::make(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent) {
|
|
return RC<GenericWhereClauseSyntaxData> {
|
|
new GenericWhereClauseSyntaxData { Raw, Parent, IndexInParent }
|
|
};
|
|
}
|
|
|
|
RC<GenericWhereClauseSyntaxData> GenericWhereClauseSyntaxData::makeBlank() {
|
|
return make(RawSyntax::make(SyntaxKind::GenericWhereClause,
|
|
{
|
|
RawSyntax::missing(SyntaxKind::TypeIdentifier),
|
|
TokenSyntax::missingToken(tok::equal, "="),
|
|
RawSyntax::missing(SyntaxKind::MissingType),
|
|
},
|
|
SourcePresence::Present));
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-where-clause API
|
|
|
|
GenericWhereClauseSyntax::
|
|
GenericWhereClauseSyntax(RC<SyntaxData> Root,
|
|
const GenericWhereClauseSyntaxData *Data)
|
|
: Syntax(Root, Data) {}
|
|
|
|
#pragma mark -
|
|
#pragma mark same-type-requirement Data
|
|
|
|
SameTypeRequirementSyntaxData::
|
|
SameTypeRequirementSyntaxData(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent)
|
|
: SyntaxData(Raw, Parent, IndexInParent) {
|
|
// TODO: kind assertions
|
|
}
|
|
|
|
RC<SameTypeRequirementSyntaxData>
|
|
SameTypeRequirementSyntaxData::make(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent) {
|
|
return RC<SameTypeRequirementSyntaxData> {
|
|
new SameTypeRequirementSyntaxData {
|
|
Raw, Parent, IndexInParent
|
|
}
|
|
};
|
|
}
|
|
|
|
RC<SameTypeRequirementSyntaxData> SameTypeRequirementSyntaxData::makeBlank() {
|
|
return make(RawSyntax::make(SyntaxKind::SameTypeRequirement,
|
|
{
|
|
RawSyntax::missing(SyntaxKind::TypeIdentifier),
|
|
TokenSyntax::missingToken(tok::equal, "="),
|
|
RawSyntax::missing(SyntaxKind::MissingType),
|
|
},
|
|
SourcePresence::Present));
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark same-type-requirement API
|
|
|
|
SameTypeRequirementSyntax::
|
|
SameTypeRequirementSyntax(RC<SyntaxData> Root,
|
|
const SameTypeRequirementSyntaxData *Data)
|
|
: Syntax(Root, Data) {}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-argument-clause Data
|
|
|
|
GenericArgumentClauseSyntaxData::
|
|
GenericArgumentClauseSyntaxData(RC<RawSyntax> Raw, const SyntaxData *Parent,
|
|
CursorIndex IndexInParent)
|
|
: SyntaxData(Raw, Parent, IndexInParent) {}
|
|
|
|
RC<GenericArgumentClauseSyntaxData>
|
|
GenericArgumentClauseSyntaxData::make(RC<RawSyntax> Raw,
|
|
const SyntaxData *Parent,
|
|
CursorIndex IndexInParent) {
|
|
return RC<GenericArgumentClauseSyntaxData> {
|
|
new GenericArgumentClauseSyntaxData { Raw, Parent, IndexInParent }
|
|
};
|
|
}
|
|
|
|
RC<GenericArgumentClauseSyntaxData>
|
|
GenericArgumentClauseSyntaxData::makeBlank() {
|
|
auto Raw = RawSyntax::make(SyntaxKind::GenericArgumentClause,
|
|
{
|
|
TokenSyntax::missingToken(tok::l_angle, "<"),
|
|
RawSyntax::missing(SyntaxKind::TypeArgumentList),
|
|
TokenSyntax::missingToken(tok::r_angle, ">"),
|
|
},
|
|
SourcePresence::Present);
|
|
return make(Raw);
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-argument-clause API
|
|
|
|
GenericArgumentClauseSyntax::
|
|
GenericArgumentClauseSyntax(RC<SyntaxData> Root,
|
|
const GenericArgumentClauseSyntaxData *Data)
|
|
: Syntax(Root, Data) {}
|
|
|
|
GenericArgumentClauseSyntax GenericArgumentClauseSyntax::
|
|
withLeftAngleBracket(RC<TokenSyntax> NewLeftAngleBracket) const {
|
|
syntax_assert_token_is(NewLeftAngleBracket, tok::l_angle, "<");
|
|
return Data->replaceChild<GenericArgumentClauseSyntax>(
|
|
NewLeftAngleBracket, Cursor::LeftAngleBracketToken);
|
|
}
|
|
|
|
|
|
|
|
GenericArgumentClauseSyntax GenericArgumentClauseSyntax::
|
|
withRightAngleBracket(RC<TokenSyntax> NewRightAngleBracket) const {
|
|
syntax_assert_token_is(NewRightAngleBracket, tok::r_angle, ">");
|
|
return Data->replaceChild<GenericArgumentClauseSyntax>(
|
|
NewRightAngleBracket, Cursor::RightAngleBracketToken);
|
|
}
|
|
|
|
#pragma mark -
|
|
#pragma mark generic-argument-clause Builder
|
|
|
|
GenericArgumentClauseBuilder::GenericArgumentClauseBuilder()
|
|
: ArgumentListLayout(
|
|
SyntaxFactory::makeBlankGenericArgumentClause().getRaw()->Layout) {}
|
|
|
|
GenericArgumentClauseBuilder &GenericArgumentClauseBuilder::
|
|
useLeftAngleBracket(RC<TokenSyntax> LeftAngle) {
|
|
syntax_assert_token_is(LeftAngle, tok::l_angle, "<");
|
|
LeftAngleToken = LeftAngle;
|
|
return *this;
|
|
}
|
|
|
|
GenericArgumentClauseBuilder &GenericArgumentClauseBuilder::
|
|
addGenericArgument(llvm::Optional<RC<TokenSyntax>> MaybeComma,
|
|
TypeSyntax ArgumentTypeSyntax) {
|
|
if (MaybeComma.hasValue()) {
|
|
syntax_assert_token_is(MaybeComma.getValue(), tok::comma, ",");
|
|
ArgumentListLayout.push_back(MaybeComma.getValue());
|
|
} else {
|
|
ArgumentListLayout.push_back(TokenSyntax::missingToken(tok::comma, ","));
|
|
}
|
|
ArgumentListLayout.push_back(ArgumentTypeSyntax.getRaw());
|
|
return *this;
|
|
}
|
|
|
|
GenericArgumentClauseBuilder &GenericArgumentClauseBuilder::
|
|
useRightAngleBracket(RC<TokenSyntax> RightAngle) {
|
|
syntax_assert_token_is(RightAngle, tok::r_angle, ">");
|
|
RightAngleToken = RightAngle;
|
|
return *this;
|
|
}
|
|
|
|
|
|
GenericArgumentClauseSyntax GenericArgumentClauseBuilder::build() const {
|
|
auto ArgListRaw = RawSyntax::make(SyntaxKind::TypeArgumentList,
|
|
ArgumentListLayout,
|
|
SourcePresence::Present);
|
|
auto Raw = RawSyntax::make(SyntaxKind::GenericArgumentClause,
|
|
{
|
|
LeftAngleToken,
|
|
ArgListRaw,
|
|
RightAngleToken
|
|
},
|
|
SourcePresence::Present);
|
|
auto Data = GenericArgumentClauseSyntaxData::make(Raw);
|
|
return { Data, Data.get() };
|
|
}
|