mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
This completes the FileUnit refactoring. A module consists of multiple FileUnits, which provide decls from various file-like sources. I say "file-like" because the Builtin module is implemented with a single BuiltinUnit, and imported Clang modules are just a single FileUnit source within a module. Most modules, therefore, contain a single file unit; only the main module will contain multiple source files (and eventually partial AST files). The term "translation unit" has been scrubbed from the project. To refer to the context of declarations outside of any other declarations, use "top-level" or "module scope". To refer to a .swift file or its DeclContext, use "source file". To refer to a single unit of compilation, use "module", since the model is that an entire module will be compiled with a single driver call. (It will still be possible to compile a single source file through the direct-to-frontend interface, but only in the context of the whole module.) Swift SVN r10837
241 lines
8.9 KiB
C++
241 lines
8.9 KiB
C++
//===-- Frontend.cpp - frontend utility methods ---------------------------===//
|
|
//
|
|
// 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file contains utility methods for parsing and performing semantic
|
|
// on modules.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "swift/AST/ASTContext.h"
|
|
#include "swift/AST/Diagnostics.h"
|
|
#include "swift/AST/Module.h"
|
|
#include "swift/Basic/SourceManager.h"
|
|
#include "swift/Frontend/Frontend.h"
|
|
#include "swift/Parse/DelayedParsingCallbacks.h"
|
|
#include "swift/Parse/Lexer.h"
|
|
#include "swift/SIL/SILModule.h"
|
|
#include "swift/Serialization/SerializedModuleLoader.h"
|
|
#include "swift/Subsystems.h"
|
|
#include "llvm/Support/MemoryBuffer.h"
|
|
#include "llvm/Support/Path.h"
|
|
|
|
using namespace swift;
|
|
|
|
void swift::CompilerInstance::createSILModule() {
|
|
assert(getMainModule());
|
|
TheSILModule = SILModule::createEmptyModule(getMainModule());
|
|
}
|
|
|
|
bool swift::CompilerInstance::setup(const CompilerInvocation &Invok) {
|
|
Invocation = Invok;
|
|
|
|
Context.reset(new ASTContext(Invocation.getLangOptions(), SourceMgr, Diagnostics));
|
|
|
|
// Give the context the list of search paths to use for modules.
|
|
Context->ImportSearchPaths = Invocation.getImportSearchPaths();
|
|
Context->addModuleLoader(SourceLoader::create(*Context,
|
|
!Invocation.isImmediate()));
|
|
SML = SerializedModuleLoader::create(*Context);
|
|
Context->addModuleLoader(SML);
|
|
|
|
// If the user has specified an SDK, wire up the Clang module importer
|
|
// and point it at that SDK.
|
|
if (!Invocation.getSDKPath().empty()) {
|
|
auto ImporterCtor = swift::getClangImporterCtor();
|
|
if (!ImporterCtor) {
|
|
Diagnostics.diagnose(SourceLoc(),
|
|
diag::error_clang_importer_not_linked_in);
|
|
return true;
|
|
}
|
|
auto clangImporter =
|
|
ImporterCtor(*Context, Invocation.getSDKPath(),
|
|
Invocation.getTargetTriple(),
|
|
Invocation.getRuntimeIncludePath(),
|
|
Invocation.getClangModuleCachePath(),
|
|
Invocation.getImportSearchPaths(),
|
|
Invocation.getFrameworkSearchPaths(),
|
|
StringRef(), Invocation.getExtraClangArgs());
|
|
if (!clangImporter) {
|
|
Diagnostics.diagnose(SourceLoc(), diag::error_clang_importer_create_fail);
|
|
return true;
|
|
}
|
|
|
|
Context->addModuleLoader(clangImporter, /*isClang*/true);
|
|
}
|
|
|
|
// Add the runtime include path (which contains swift.swift)
|
|
Context->ImportSearchPaths.push_back(Invocation.getRuntimeIncludePath());
|
|
|
|
assert(Lexer::isIdentifier(Invocation.getModuleName()));
|
|
|
|
auto CodeCompletePoint = Invocation.getCodeCompletionPoint();
|
|
if (CodeCompletePoint.first) {
|
|
auto MemBuf = CodeCompletePoint.first;
|
|
// CompilerInvocation doesn't own the buffers, copy to a new buffer.
|
|
llvm::MemoryBuffer *CodeCompletionBuffer =
|
|
llvm::MemoryBuffer::getMemBufferCopy(MemBuf->getBuffer(),
|
|
MemBuf->getBufferIdentifier());
|
|
unsigned CodeCompletionBufferID =
|
|
SourceMgr.addNewSourceBuffer(CodeCompletionBuffer);
|
|
BufferIDs.push_back(CodeCompletionBufferID);
|
|
SourceMgr.setCodeCompletionPoint(CodeCompletionBufferID,
|
|
CodeCompletePoint.second);
|
|
}
|
|
|
|
bool MainMode = (Invocation.getInputKind() == SourceFileKind::Main);
|
|
bool SILMode = (Invocation.getInputKind() == SourceFileKind::SIL);
|
|
|
|
// Add the memory buffers first, these will be associated with a filename
|
|
// and they can replace the contents of an input filename.
|
|
for (auto Buf : Invocation.getInputBuffers()) {
|
|
if (SILMode)
|
|
MainBufferIndex = BufferIDs.size();
|
|
|
|
// CompilerInvocation doesn't own the buffers, copy to a new buffer.
|
|
BufferIDs.push_back(SourceMgr.addNewSourceBuffer(
|
|
llvm::MemoryBuffer::getMemBufferCopy(Buf->getBuffer(),
|
|
Buf->getBufferIdentifier())));
|
|
}
|
|
|
|
for (auto &File : Invocation.getInputFilenames()) {
|
|
// FIXME: Working with filenames is fragile, maybe use the real path
|
|
// or have some kind of FileManager.
|
|
if (SourceMgr.getIDForBufferIdentifier(File).hasValue())
|
|
continue; // replaced by a memory buffer.
|
|
|
|
// Open the input file.
|
|
llvm::OwningPtr<llvm::MemoryBuffer> InputFile;
|
|
if (llvm::error_code Err =
|
|
llvm::MemoryBuffer::getFileOrSTDIN(File, InputFile)) {
|
|
Diagnostics.diagnose(SourceLoc(), diag::error_open_input_file,
|
|
File, Err.message());
|
|
return true;
|
|
}
|
|
|
|
using namespace llvm::sys::path;
|
|
if (SILMode || (MainMode && filename(File) == "main.swift"))
|
|
MainBufferIndex = BufferIDs.size();
|
|
|
|
// Transfer ownership of the MemoryBuffer to the SourceMgr.
|
|
BufferIDs.push_back(SourceMgr.addNewSourceBuffer(InputFile.take()));
|
|
}
|
|
|
|
if (MainMode && MainBufferIndex == NO_SUCH_BUFFER && BufferIDs.size() == 1)
|
|
MainBufferIndex = 0;
|
|
|
|
return false;
|
|
}
|
|
|
|
void swift::CompilerInstance::doIt() {
|
|
const SourceFileKind Kind = Invocation.getInputKind();
|
|
Identifier ID = Context->getIdentifier(Invocation.getModuleName());
|
|
MainModule = new (*Context) Module(ID, *Context);
|
|
Context->LoadedModules[ID.str()] = MainModule;
|
|
|
|
if (Kind == SourceFileKind::SIL) {
|
|
assert(BufferIDs.size() == 1);
|
|
assert(MainBufferIndex != NO_SUCH_BUFFER);
|
|
createSILModule();
|
|
}
|
|
|
|
if (Kind == SourceFileKind::REPL) {
|
|
auto *SingleInputFile =
|
|
new (*Context) SourceFile(*MainModule, Kind, {},
|
|
Invocation.getParseStdlib());
|
|
MainModule->addFile(*SingleInputFile);
|
|
return;
|
|
}
|
|
|
|
std::unique_ptr<DelayedParsingCallbacks> DelayedCB;
|
|
if (Invocation.isCodeCompletion()) {
|
|
DelayedCB.reset(
|
|
new CodeCompleteDelayedCallbacks(SourceMgr.getCodeCompletionLoc()));
|
|
} else if (Invocation.isDelayedFunctionBodyParsing()) {
|
|
DelayedCB.reset(new AlwaysDelayedCallbacks);
|
|
}
|
|
|
|
PersistentParserState PersistentState;
|
|
|
|
// Make sure the main file is the first file in the module. This may only be
|
|
// a source file, or it may be a SIL file, which requires pumping the parser.
|
|
// We parse it last, though, to make sure that it can use decls from other
|
|
// files in the module.
|
|
if (MainBufferIndex != NO_SUCH_BUFFER) {
|
|
assert(Kind == SourceFileKind::Main || Kind == SourceFileKind::SIL);
|
|
|
|
unsigned BufferID = BufferIDs[MainBufferIndex];
|
|
if (Kind == SourceFileKind::Main)
|
|
SourceMgr.setHashbangBufferID(BufferID);
|
|
|
|
auto *SingleInputFile =
|
|
new (*Context) SourceFile(*MainModule, Kind, BufferID,
|
|
Invocation.getParseStdlib());
|
|
MainModule->addFile(*SingleInputFile);
|
|
}
|
|
|
|
// Parse all the library files first.
|
|
for (size_t i = 0, e = BufferIDs.size(); i < e; ++i) {
|
|
if (i == MainBufferIndex)
|
|
continue;
|
|
auto BufferID = BufferIDs[i];
|
|
|
|
auto *NextInput = new (*Context) SourceFile(*MainModule,
|
|
SourceFileKind::Library,
|
|
BufferID,
|
|
Invocation.getParseStdlib());
|
|
MainModule->addFile(*NextInput);
|
|
|
|
bool Done;
|
|
parseIntoSourceFile(*NextInput, BufferID, &Done, nullptr,
|
|
&PersistentState, DelayedCB.get());
|
|
assert(Done && "Parser returned early?");
|
|
(void) Done;
|
|
|
|
performNameBinding(*NextInput);
|
|
}
|
|
|
|
// Parse the main file last.
|
|
if (MainBufferIndex != NO_SUCH_BUFFER) {
|
|
SourceFile &MainFile = MainModule->getMainSourceFile(Kind);
|
|
SILParserState SILContext(TheSILModule.get());
|
|
|
|
unsigned CurTUElem = 0;
|
|
bool Done;
|
|
do {
|
|
// Pump the parser multiple times if necessary. It will return early
|
|
// after parsing any top level code in a main module, or in SIL mode when
|
|
// there are chunks of swift decls (e.g. imports and types) interspersed
|
|
// with 'sil' definitions.
|
|
parseIntoSourceFile(MainFile, MainFile.getBufferID().getValue(), &Done,
|
|
TheSILModule ? &SILContext : nullptr,
|
|
&PersistentState, DelayedCB.get());
|
|
if (!Invocation.getParseOnly())
|
|
performTypeChecking(MainFile, CurTUElem);
|
|
CurTUElem = MainFile.Decls.size();
|
|
} while (!Done);
|
|
}
|
|
|
|
if (!Invocation.getParseOnly()) {
|
|
// Type-check each top-level input besides the main source file.
|
|
auto InputSourceFiles = MainModule->getFiles().slice(0, BufferIDs.size());
|
|
for (auto File : InputSourceFiles)
|
|
if (auto SF = dyn_cast<SourceFile>(File))
|
|
performTypeChecking(*SF);
|
|
}
|
|
|
|
if (DelayedCB) {
|
|
performDelayedParsing(MainModule, PersistentState,
|
|
Invocation.getCodeCompletionFactory());
|
|
}
|
|
}
|
|
|