// Copyright 2021 gRPC authors. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #ifndef GRPC_SRC_CORE_LIB_PROMISE_MAP_H #define GRPC_SRC_CORE_LIB_PROMISE_MAP_H #include #include #include #include #include "absl/status/status.h" #include "absl/status/statusor.h" #include "absl/strings/str_cat.h" #include "src/core/lib/promise/detail/promise_like.h" #include "src/core/lib/promise/poll.h" namespace grpc_core { namespace promise_detail { // Implementation of mapping combinator - use this via the free function below! // Promise is the type of promise to poll on, Fn is a function that takes the // result of Promise and maps it to some new type. template class Map; template class Map= 201703L) || \ (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) std::invoke_result_t::Result> #else typename std::result_of::Result)>::type #endif >::value>> { public: GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION Map(Promise promise, Fn fn) : promise_(std::move(promise)), fn_(std::move(fn)) {} Map(const Map&) = delete; Map& operator=(const Map&) = delete; // NOLINTNEXTLINE(performance-noexcept-move-constructor): clang6 bug Map(Map&& other) = default; // NOLINTNEXTLINE(performance-noexcept-move-constructor): clang6 bug Map& operator=(Map&& other) = default; using PromiseResult = typename PromiseLike::Result; using Result = RemoveCVRef()(std::declval()))>; GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION Poll operator()() { Poll r = promise_(); if (auto* p = r.value_if_ready()) { return fn_(std::move(*p)); } return Pending(); } private: PromiseLike promise_; Fn fn_; }; template class Map= 201703L) || \ (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) std::invoke_result_t::Result> #else typename std::result_of::Result)>::type #endif >::value>> { public: GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION Map(Promise promise, Fn fn) : promise_(std::move(promise)), fn_(std::move(fn)) {} Map(const Map&) = delete; Map& operator=(const Map&) = delete; // NOLINTNEXTLINE(performance-noexcept-move-constructor): clang6 bug Map(Map&& other) = default; // NOLINTNEXTLINE(performance-noexcept-move-constructor): clang6 bug Map& operator=(Map&& other) = default; using PromiseResult = typename PromiseLike::Result; using Result = Empty; GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION Poll operator()() { Poll r = promise_(); if (auto* p = r.value_if_ready()) { fn_(std::move(*p)); return Empty{}; } return Pending(); } private: PromiseLike promise_; Fn fn_; }; } // namespace promise_detail // Mapping combinator. // Takes a promise, and a synchronous function to mutate its result, and // returns a promise. template GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION inline promise_detail::Map Map(Promise promise, Fn fn) { return promise_detail::Map(std::move(promise), std::move(fn)); } // Maps a promise to a new promise that returns a tuple of the original result // and a bool indicating whether there was ever a Pending{} value observed from // polling. template GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION inline auto CheckDelayed(Promise promise) { using P = promise_detail::PromiseLike; return [delayed = false, promise = P(std::move(promise))]() mutable -> Poll> { auto r = promise(); if (r.pending()) { delayed = true; return Pending{}; } return std::make_tuple(std::move(r.value()), delayed); }; } // Callable that takes a tuple and returns one element template struct JustElem { template GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION auto operator()(std::tuple&& t) const -> decltype(std::get(std::forward>(t))) { return std::get(std::forward>(t)); } template GPR_ATTRIBUTE_ALWAYS_INLINE_FUNCTION auto operator()( const std::tuple& t) const -> decltype(std::get(t)) { return std::get(t); } }; namespace promise_detail { template class MapError { public: explicit MapError(Fn fn) : fn_(std::move(fn)) {} absl::Status operator()(absl::Status status) { if (status.ok()) return status; return fn_(std::move(status)); } template absl::StatusOr operator()(absl::StatusOr status) { if (status.ok()) return status; return fn_(std::move(status.status())); } private: Fn fn_; }; } // namespace promise_detail // Map status->better status in the case of errors template auto MapErrors(Promise promise, Fn fn) { return Map(std::move(promise), promise_detail::MapError(std::move(fn))); } // Simple mapper to add a prefix to the message of an error template auto AddErrorPrefix(absl::string_view prefix, Promise promise) { return MapErrors(std::move(promise), [prefix](absl::Status status) { absl::Status out(status.code(), absl::StrCat(prefix, status.message())); status.ForEachPayload( [&out](absl::string_view name, const absl::Cord& value) { out.SetPayload(name, value); }); return out; }); } } // namespace grpc_core #endif // GRPC_SRC_CORE_LIB_PROMISE_MAP_H