Files
clang-p2996/lldb/tools/lldb-vscode/FifoFiles.h
serge-sans-paille e9211e0393 Remove dependency from raw_ostream on <chrono>
The tryLockFor method from raw_fd_sotreamis the sole user of that
header, and it's not referenced in the mono repo. I still chose to keep
it (may be useful for downstream user) but added a transient type that's
forward declared to hold the duration parameter.

Notable changes:

- "llvm/Support/Duration.h" must be included in order to use tryLockFor.
- "llvm/Support/raw_ostream.h" no longer includes <chrono>

This sole change has an interesting impact on the number of processed
line, as measured by:

clang++ -E  -Iinclude -I../llvm/include ../llvm/lib/Support/*.cpp -std=c++14 -fno-rtti -fno-exceptions | wc -l

before: 7917500
after:  7835142

Discourse thread on the topic: https://llvm.discourse.group/t/include-what-you-use-include-cleanup/5831
2022-01-21 15:17:39 +01:00

88 lines
2.8 KiB
C++

//===-- FifoFiles.h ---------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#ifndef LLDB_TOOLS_LLDB_VSCODE_FIFOFILES_H
#define LLDB_TOOLS_LLDB_VSCODE_FIFOFILES_H
#include "llvm/Config/llvm-config.h" // for LLVM_ON_UNIX
#include "llvm/Support/Error.h"
#include "JSONUtils.h"
#include <chrono>
namespace lldb_vscode {
/// Struct that controls the life of a fifo file in the filesystem.
///
/// The file is destroyed when the destructor is invoked.
struct FifoFile {
FifoFile(llvm::StringRef path);
~FifoFile();
std::string m_path;
};
/// Create a fifo file in the filesystem.
///
/// \param[in] path
/// The path for the fifo file.
///
/// \return
/// A \a std::shared_ptr<FifoFile> if the file could be created, or an
/// \a llvm::Error in case of failures.
llvm::Expected<std::shared_ptr<FifoFile>> CreateFifoFile(llvm::StringRef path);
class FifoFileIO {
public:
/// \param[in] fifo_file
/// The path to an input fifo file that exists in the file system.
///
/// \param[in] other_endpoint_name
/// A human readable name for the other endpoint that will communicate
/// using this file. This is used for error messages.
FifoFileIO(llvm::StringRef fifo_file, llvm::StringRef other_endpoint_name);
/// Read the next JSON object from the underlying input fifo file.
///
/// The JSON object is expected to be a single line delimited with \a
/// std::endl.
///
/// \return
/// An \a llvm::Error object indicating the success or failure of this
/// operation. Failures arise if the timeout is hit, the next line of text
/// from the fifo file is not a valid JSON object, or is it impossible to
/// read from the file.
llvm::Expected<llvm::json::Value> ReadJSON(std::chrono::milliseconds timeout);
/// Serialize a JSON object and write it to the underlying output fifo file.
///
/// \param[in] json
/// The JSON object to send. It will be printed as a single line delimited
/// with \a std::endl.
///
/// \param[in] timeout
/// A timeout for how long we should until for the data to be consumed.
///
/// \return
/// An \a llvm::Error object indicating whether the data was consumed by
/// a reader or not.
llvm::Error SendJSON(
const llvm::json::Value &json,
std::chrono::milliseconds timeout = std::chrono::milliseconds(20000));
private:
std::string m_fifo_file;
std::string m_other_endpoint_name;
};
} // namespace lldb_vscode
#endif // LLDB_TOOLS_LLDB_VSCODE_FIFOFILES_H