mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
This is phase-1 of switching from llvm::Optional to std::optional in the
next rebranch. llvm::Optional was removed from upstream LLVM, so we need
to migrate off rather soon. On Darwin, std::optional, and llvm::Optional
have the same layout, so we don't need to be as concerned about ABI
beyond the name mangling. `llvm::Optional` is only returned from one
function in
```
getStandardTypeSubst(StringRef TypeName,
bool allowConcurrencyManglings);
```
It's the return value, so it should not impact the mangling of the
function, and the layout is the same as `std::optional`, so it should be
mostly okay. This function doesn't appear to have users, and the ABI was
already broken 2 years ago for concurrency and no one seemed to notice
so this should be "okay".
I'm doing the migration incrementally so that folks working on main can
cherry-pick back to the release/5.9 branch. Once 5.9 is done and locked
away, then we can go through and finish the replacement. Since `None`
and `Optional` show up in contexts where they are not `llvm::None` and
`llvm::Optional`, I'm preparing the work now by going through and
removing the namespace unwrapping and making the `llvm` namespace
explicit. This should make it fairly mechanical to go through and
replace llvm::Optional with std::optional, and llvm::None with
std::nullopt. It's also a change that can be brought onto the
release/5.9 with minimal impact. This should be an NFC change.
79 lines
2.9 KiB
C++
79 lines
2.9 KiB
C++
//===----- ParseableOutput.h - Helpers for parseable output ------- C++ -*-===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2020 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
///
|
|
/// \file
|
|
/// Helpers for emitting the compiler's parseable output.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_PARSEABLEOUTPUT_H
|
|
#define SWIFT_PARSEABLEOUTPUT_H
|
|
|
|
#include "swift/Basic/LLVM.h"
|
|
#include "swift/Basic/TaskQueue.h"
|
|
#include "swift/Basic/FileTypes.h"
|
|
|
|
namespace swift {
|
|
|
|
namespace parseable_output {
|
|
|
|
/// Quasi-PIDs are _negative_ PID-like unique keys used to
|
|
/// masquerade batch job constituents as (quasi)processes, when writing
|
|
/// parseable output to consumers that don't understand the idea of a batch
|
|
/// job. They are negative in order to avoid possibly colliding with real
|
|
/// PIDs (which are always positive). We start at -1000 here as a crude but
|
|
/// harmless hedge against colliding with an errno value that might slip
|
|
/// into the stream of real PIDs (say, due to a TaskQueue bug).
|
|
const int QUASI_PID_START = -1000;
|
|
|
|
struct CommandInput {
|
|
std::string Path;
|
|
CommandInput() {}
|
|
CommandInput(StringRef Path) : Path(Path) {}
|
|
};
|
|
|
|
using OutputPair = std::pair<file_types::ID, std::string>;
|
|
|
|
/// A client-agnostic (e.g. either the compiler driver or `swift-frontend`)
|
|
/// description of a task that is the subject of a parseable-output message.
|
|
struct DetailedTaskDescription {
|
|
std::string Executable;
|
|
SmallVector<std::string, 16> Arguments;
|
|
std::string CommandLine;
|
|
SmallVector<CommandInput, 4> Inputs;
|
|
SmallVector<OutputPair, 8> Outputs;
|
|
};
|
|
|
|
/// Emits a "began" message to the given stream.
|
|
void emitBeganMessage(raw_ostream &os, StringRef Name,
|
|
DetailedTaskDescription TascDesc,
|
|
int64_t Pid, sys::TaskProcessInformation ProcInfo);
|
|
|
|
/// Emits a "finished" message to the given stream.
|
|
void emitFinishedMessage(raw_ostream &os, StringRef Name,
|
|
std::string Output, int ExitStatus,
|
|
int64_t Pid, sys::TaskProcessInformation ProcInfo);
|
|
|
|
/// Emits a "signalled" message to the given stream.
|
|
void emitSignalledMessage(raw_ostream &os, StringRef Name, StringRef ErrorMsg,
|
|
StringRef Output, llvm::Optional<int> Signal,
|
|
int64_t Pid, sys::TaskProcessInformation ProcInfo);
|
|
|
|
/// Emits a "skipped" message to the given stream.
|
|
void emitSkippedMessage(raw_ostream &os, StringRef Name,
|
|
DetailedTaskDescription TascDesc);
|
|
|
|
} // end namespace parseable_output
|
|
} // end namespace swift
|
|
|
|
#endif
|