mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
aba3b6c24e
It has an extension .package.swiftinterface and contains package decls as well as SPIs and public/inlinable decls. When a module is loaded from interface, it now looks up the package-name in the interface and checks if the importer is in the same package. If so, it uses that package interface found to load the module. If not, uses the existing logic to load modules. Resolves rdar://104617854
119 lines
4.2 KiB
C++
119 lines
4.2 KiB
C++
//===------ ModuleInterfaceSupport.h - swiftinterface files -----*- C++ -*-===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2019 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 SWIFT_FRONTEND_MODULEINTERFACESUPPORT_H
|
|
#define SWIFT_FRONTEND_MODULEINTERFACESUPPORT_H
|
|
|
|
#include "swift/Basic/LLVM.h"
|
|
#include "swift/Basic/Version.h"
|
|
#include "llvm/Support/Regex.h"
|
|
|
|
#define SWIFT_INTERFACE_FORMAT_VERSION_KEY "swift-interface-format-version"
|
|
#define SWIFT_COMPILER_VERSION_KEY "swift-compiler-version"
|
|
#define SWIFT_MODULE_FLAGS_KEY "swift-module-flags"
|
|
#define SWIFT_MODULE_FLAGS_IGNORABLE_KEY "swift-module-flags-ignorable"
|
|
#define SWIFT_MODULE_FLAGS_IGNORABLE_PRIVATE_KEY "swift-module-flags-ignorable-private"
|
|
|
|
namespace swift {
|
|
|
|
class ASTContext;
|
|
class ModuleDecl;
|
|
|
|
/// Options for controlling the generation of the .swiftinterface output.
|
|
struct ModuleInterfaceOptions {
|
|
/// Should we prefer printing TypeReprs when writing out types in a module
|
|
/// interface, or should we fully-qualify them?
|
|
bool PreserveTypesAsWritten = false;
|
|
|
|
/// Use aliases when printing references to modules to avoid ambiguities
|
|
/// with types sharing a name with a module.
|
|
bool AliasModuleNames = false;
|
|
|
|
/// See \ref FrontendOptions.PrintFullConvention.
|
|
/// [TODO: Clang-type-plumbing] This check should go away.
|
|
bool PrintFullConvention = false;
|
|
|
|
/// Copy of all the command-line flags passed at .swiftinterface
|
|
/// generation time, re-applied to CompilerInvocation when reading
|
|
/// back .swiftinterface and reconstructing .swiftmodule.
|
|
std::string Flags;
|
|
|
|
/// Flags that should be emitted to the .swiftinterface file but are OK to be
|
|
/// ignored by the earlier version of the compiler.
|
|
std::string IgnorableFlags;
|
|
|
|
/// Ignorable flags that should only be printed in .private.swiftinterface file;
|
|
/// e.g. -package-name PACKAGE_ID
|
|
std::string IgnorablePrivateFlags;
|
|
|
|
/// Prints package, SPIs, or public/inlinable decls depending on the mode.
|
|
PrintInterfaceContentMode InterfaceContentMode = PrintInterfaceContentMode::Public;
|
|
|
|
/// Print imports with both @_implementationOnly and @_spi, only applies
|
|
/// when PrintSPIs is true.
|
|
bool ExperimentalSPIImports = false;
|
|
|
|
/// Print imports that are missing from the source and used in API.
|
|
bool PrintMissingImports = true;
|
|
|
|
/// Intentionally print invalid syntax into the file.
|
|
bool DebugPrintInvalidSyntax = false;
|
|
|
|
/// A list of modules we shouldn't import in the public interfaces.
|
|
std::vector<std::string> ModulesToSkipInPublicInterface;
|
|
};
|
|
|
|
extern version::Version InterfaceFormatVersion;
|
|
std::string getSwiftInterfaceCompilerVersionForCurrentCompiler(ASTContext &ctx);
|
|
|
|
/// A regex that matches lines like this:
|
|
///
|
|
/// // swift-interface-format-version: 1.0
|
|
///
|
|
/// and extracts "1.0".
|
|
llvm::Regex getSwiftInterfaceFormatVersionRegex();
|
|
|
|
/// A regex that matches lines like this:
|
|
///
|
|
/// // swift-compiler-version: Apple Swift version 5.8 (swiftlang-5.8.0.117.59)
|
|
///
|
|
/// and extracts "Apple Swift version 5.8 (swiftlang-5.8.0.117.59)".
|
|
llvm::Regex getSwiftInterfaceCompilerVersionRegex();
|
|
|
|
/// A regex that matches strings like this:
|
|
///
|
|
/// Apple Swift version 5.8
|
|
///
|
|
/// and extracts "5.8".
|
|
llvm::Regex getSwiftInterfaceCompilerToolsVersionRegex();
|
|
|
|
/// Emit a stable module interface for \p M, which can be used by a client
|
|
/// source file to import this module, subject to options given by \p Opts.
|
|
///
|
|
/// Unlike a serialized module, the textual format generated by
|
|
/// emitSwiftInterface is intended to be stable across compiler versions while
|
|
/// still describing the full ABI of the module in question.
|
|
///
|
|
/// The initial plan for this format can be found at
|
|
/// https://forums.swift.org/t/plan-for-module-stability/14551/
|
|
///
|
|
/// \return true if an error occurred
|
|
///
|
|
/// \sa swift::serialize
|
|
bool emitSwiftInterface(raw_ostream &out,
|
|
ModuleInterfaceOptions const &Opts,
|
|
ModuleDecl *M);
|
|
|
|
} // end namespace swift
|
|
|
|
#endif
|