llvm/lldb/unittests/TestingSupport/SubsystemRAII.h

//===- SubsystemRAII.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_UNITTESTS_TESTINGSUPPORT_SUBSYSTEMRAII_H
#define LLDB_UNITTESTS_TESTINGSUPPORT_SUBSYSTEMRAII_H

#include "llvm/Support/Error.h"
#include "llvm/Testing/Support/Error.h"
#include "gtest/gtest.h"
#include <type_traits>

namespace lldb_private {

namespace detail {
/// Initializes and deinitializes a single subsystem.
/// @see SubsystemRAII
template <typename T> struct SubsystemRAIICase { … };
} // namespace detail

template <typename... T> class SubsystemRAII { … };

/// RAII for initializing and deinitializing LLDB subsystems.
///
/// This RAII takes care of calling the Initialize and Terminate functions for
/// the subsystems specified by its template arguments. The ::Initialize
/// functions are called on construction for each subsystem template parameter
/// in the order in which they are passed as template parameters.
/// The ::Terminate functions are called in the reverse order at destruction
/// time.
///
/// If the ::Initialize function returns an llvm::Error this function handles
/// the Error instance (by checking that there is no error).
///
/// Constructing this RAII in a scope like this:
///
///   @code{.cpp}
///   {
///     SubsystemRAII<FileSystem, HostInfo, Socket> Subsystems;
///     DoingTestWork();
///   }
///   @endcode
///
/// is equivalent to the following code:
///
///   @code{.cpp}
///   {
///     FileSystem::Initialize();
///     HostInfo::Initialize();
///     ASSERT_THAT_ERROR(Socket::Initialize(), llvm::Succeeded());
///
///     DoingTestWork();
///
///     Socket::Terminate();
///     FileSystem::Terminate();
///     HostInfo::Terminate();
///   }
///   @endcode
SubsystemRAII<T, Ts...>;
} // namespace lldb_private

#endif // LLDB_UNITTESTS_TESTINGSUPPORT_SUBSYSTEMRAII_H