// Copyright 2022 The Pigweed 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 // // https://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. // pw::Result is derived from absl::StatusOr, but has some small differences. // This test covers basic pw::Result functionality and as well as the features // supported by pw::Result that are not supported by absl::StatusOr (constexpr // use in particular). // // The complete, thorough pw::Result tests are in statusor_test.cc, which is // derived from Abseil's tests for absl::StatusOr. #include "pw_result/result.h" #include #include "pw_status/status.h" #include "pw_status/try.h" #include "pw_unit_test/framework.h" namespace pw { namespace { TEST(Result, CreateOk) { Result res("hello"); EXPECT_TRUE(res.ok()); EXPECT_EQ(res.status(), OkStatus()); EXPECT_EQ(res.value(), "hello"); } TEST(Result, CreateOkTypeDeduction) { auto res = Result("hello"); static_assert(std::is_same_v>); EXPECT_TRUE(res.ok()); EXPECT_EQ(res.status(), OkStatus()); EXPECT_STREQ(res.value(), "hello"); } TEST(Result, CreateNotOk) { Result res(Status::DataLoss()); EXPECT_FALSE(res.ok()); EXPECT_EQ(res.status(), Status::DataLoss()); } TEST(Result, ValueOr) { Result good(3); Result bad(Status::DataLoss()); EXPECT_EQ(good.value_or(42), 3); EXPECT_EQ(bad.value_or(42), 42); } TEST(Result, Deref) { struct Tester { constexpr bool True() { return true; } constexpr bool False() { return false; } }; auto tester = Result(Tester()); EXPECT_TRUE(tester.ok()); EXPECT_TRUE(tester->True()); EXPECT_FALSE(tester->False()); EXPECT_TRUE((*tester).True()); EXPECT_FALSE((*tester).False()); EXPECT_EQ(tester.value().True(), tester->True()); EXPECT_EQ(tester.value().False(), tester->False()); } TEST(Result, ConstDeref) { struct Tester { constexpr bool True() const { return true; } constexpr bool False() const { return false; } }; const auto tester = Result(Tester()); EXPECT_TRUE(tester.ok()); EXPECT_TRUE(tester->True()); EXPECT_FALSE(tester->False()); EXPECT_TRUE((*tester).True()); EXPECT_FALSE((*tester).False()); EXPECT_EQ(tester.value().True(), tester->True()); EXPECT_EQ(tester.value().False(), tester->False()); } TEST(Result, ConstructType) { struct Point { Point(int a, int b) : x(a), y(b) {} int x; int y; }; Result origin{std::in_place, 0, 0}; ASSERT_TRUE(origin.ok()); ASSERT_EQ(origin.value().x, 0); ASSERT_EQ(origin.value().y, 0); } Result Divide(float a, float b) { if (b == 0) { return Status::InvalidArgument(); } return a / b; } TEST(Divide, ReturnOk) { Result res = Divide(10, 5); ASSERT_TRUE(res.ok()); EXPECT_EQ(res.value(), 2.0f); } TEST(Divide, ReturnNotOk) { Result res = Divide(10, 0); EXPECT_FALSE(res.ok()); EXPECT_EQ(res.status(), Status::InvalidArgument()); } Result ReturnResult(Result result) { return result; } Status TryResultAssign(Result result) { PW_TRY_ASSIGN(const bool value, ReturnResult(result)); // Any status other than OK should have already returned. EXPECT_EQ(result.status(), OkStatus()); EXPECT_EQ(value, result.value()); return result.status(); } TEST(Result, TryAssign) { EXPECT_EQ(TryResultAssign(Status::Cancelled()), Status::Cancelled()); EXPECT_EQ(TryResultAssign(Status::DataLoss()), Status::DataLoss()); EXPECT_EQ(TryResultAssign(Status::Unimplemented()), Status::Unimplemented()); EXPECT_EQ(TryResultAssign(false), OkStatus()); EXPECT_EQ(TryResultAssign(true), OkStatus()); } constexpr int kExpectedVal = 5; class Immovable { public: Immovable() = delete; explicit Immovable(int val) : val_(val) {} Immovable(const Immovable&) = delete; Immovable& operator=(const Immovable&) = delete; Immovable(Immovable&&) = delete; Immovable& operator=(Immovable&&) = delete; int val() { return val_; } private: int val_; }; Result MakeImmovable() { return Result(kExpectedVal); } Result TryResultAssignImmovable() { PW_TRY_ASSIGN(auto&& thingy, MakeImmovable()); return thingy.val(); } TEST(Result, TryAssignImmovable) { EXPECT_EQ(TryResultAssignImmovable(), Result(kExpectedVal)); } struct Value { int number; }; TEST(Result, ConstexprOk) { static constexpr pw::Result kResult(Value{123}); static_assert(kResult.status() == pw::OkStatus()); static_assert(kResult.ok()); static_assert((*kResult).number == 123); static_assert((*std::move(kResult)).number == 123); static_assert(kResult->number == 123); static_assert(std::move(kResult)->number == 123); static_assert(kResult.value().number == 123); static_assert(std::move(kResult).value().number == 123); static_assert(kResult.value_or(Value{99}).number == 123); static_assert(std::move(kResult).value_or(Value{99}).number == 123); } TEST(Result, ConstexprNotOk) { static constexpr pw::Result kResult(pw::Status::NotFound()); static_assert(kResult.status() == pw::Status::NotFound()); static_assert(!kResult.ok()); static_assert(kResult.value_or(Value{99}).number == 99); static_assert(std::move(kResult).value_or(Value{99}).number == 99); } TEST(Result, ConstexprNotOkCopy) { static constexpr pw::Result kResult(pw::Status::NotFound()); constexpr pw::Result kResultCopy(kResult); static_assert(kResultCopy.status() == pw::Status::NotFound()); static_assert(!kResultCopy.ok()); static_assert(kResultCopy.value_or(Value{99}).number == 99); static_assert(std::move(kResultCopy).value_or(Value{99}).number == 99); } auto multiply = [](int x) -> Result { return x * 2; }; auto add_two = [](int x) -> Result { return x + 2; }; auto fail_unknown = [](int) -> Result { return Status::Unknown(); }; TEST(Result, AndThenNonConstLValueRefInvokeSuccess) { Result r = 32; auto ret = r.and_then(multiply); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, AndThenNonConstLValueRefInvokeFail) { Result r = 32; auto ret = r.and_then(fail_unknown); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, AndThenNonConstLValueRefSkips) { Result r = Status::NotFound(); auto ret = r.and_then(multiply); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, AndThenNonConstRvalueRefInvokeSuccess) { Result r = 32; auto ret = std::move(r).and_then(multiply); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, AndThenNonConstRvalueRefInvokeFails) { Result r = 64; auto ret = std::move(r).and_then(fail_unknown); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, AndThenNonConstRvalueRefSkips) { Result r = Status::NotFound(); auto ret = std::move(r).and_then(multiply); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, AndThenConstLValueRefInvokeSuccess) { const Result r = 32; auto ret = r.and_then(multiply); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, AndThenConstLValueRefInvokeFail) { const Result r = 32; auto ret = r.and_then(fail_unknown); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, AndThenConstLValueRefSkips) { const Result r = Status::NotFound(); auto ret = r.and_then(multiply); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, AndThenConstRValueRefInvokeSuccess) { const Result r = 32; auto ret = std::move(r).and_then(multiply); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, AndThenConstRValueRefInvokeFail) { const Result r = 32; auto ret = std::move(r).and_then(fail_unknown); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, AndThenConstRValueRefSkips) { const Result r = Status::NotFound(); auto ret = std::move(r).and_then(multiply); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, AndThenMultipleChained) { Result r = 32; auto ret = r.and_then(multiply).and_then(add_two).and_then(multiply); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 132); } auto return_status = [](Status) { return Status::Unknown(); }; auto return_result = [](Status) { return Result(Status::Internal()); }; TEST(Result, OrElseNonConstLValueRefSkips) { Result r = 32; auto ret = r.or_else(return_status); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseNonConstLValueRefStatusInvokes) { Result r = Status::NotFound(); auto ret = r.or_else(return_status); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, OrElseNonConstLValueRefResultInvokes) { Result r = Status::NotFound(); auto ret = r.or_else(return_result); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Internal()); } TEST(Result, OrElseNonConstLValueRefVoidSkips) { Result r = 32; bool invoked = false; auto ret = r.or_else([&invoked](Status) { invoked = true; }); EXPECT_FALSE(invoked); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseNonConstLValueRefVoidInvokes) { Result r = Status::NotFound(); bool invoked = false; auto ret = r.or_else([&invoked](Status) { invoked = true; }); EXPECT_TRUE(invoked); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, OrElseNonConstRValueRefSkips) { Result r = 32; auto ret = std::move(r).or_else(return_status); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseNonConstRValueRefStatusInvokes) { Result r = Status::NotFound(); auto ret = std::move(r).or_else(return_status); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, OrElseNonConstRValueRefResultInvokes) { Result r = Status::NotFound(); auto ret = std::move(r).or_else(return_result); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Internal()); } TEST(Result, OrElseNonConstRValueRefVoidSkips) { Result r = 32; bool invoked = false; auto ret = std::move(r).or_else([&invoked](Status) { invoked = true; }); EXPECT_FALSE(invoked); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseNonConstRValueRefVoidInvokes) { Result r = Status::NotFound(); bool invoked = false; auto ret = std::move(r).or_else([&invoked](Status) { invoked = true; }); EXPECT_TRUE(invoked); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, OrElseConstLValueRefSkips) { const Result r = 32; auto ret = r.or_else(return_status); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseConstLValueRefStatusInvokes) { const Result r = Status::NotFound(); auto ret = r.or_else(return_status); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, OrElseConstLValueRefResultInvokes) { const Result r = Status::NotFound(); auto ret = r.or_else(return_result); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Internal()); } TEST(Result, OrElseConstLValueRefVoidSkips) { const Result r = 32; bool invoked = false; auto ret = r.or_else([&invoked](Status) { invoked = true; }); EXPECT_FALSE(invoked); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseConstLValueRefVoidInvokes) { const Result r = Status::NotFound(); bool invoked = false; auto ret = r.or_else([&invoked](Status) { invoked = true; }); EXPECT_TRUE(invoked); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, OrElseConstRValueRefSkips) { const Result r = 32; auto ret = std::move(r).or_else(return_status); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseConstRValueRefStatusInvokes) { const Result r = Status::NotFound(); auto ret = std::move(r).or_else(return_status); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Unknown()); } TEST(Result, OrElseConstRValueRefResultInvokes) { const Result r = Status::NotFound(); auto ret = std::move(r).or_else(return_result); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Internal()); } TEST(Result, OrElseConstRValueRefVoidSkips) { const Result r = 32; bool invoked = false; auto ret = std::move(r).or_else([&invoked](Status) { invoked = true; }); EXPECT_FALSE(invoked); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 32); } TEST(Result, OrElseConstRValueRefVoidInvokes) { const Result r = Status::NotFound(); bool invoked = false; auto ret = std::move(r).or_else([&invoked](Status) { invoked = true; }); EXPECT_TRUE(invoked); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, OrElseMultipleChained) { Result r = Status::NotFound(); bool invoked = false; auto ret = r.or_else(return_result).or_else([&invoked](Status) { invoked = true; }); EXPECT_TRUE(invoked); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::Internal()); } auto multiply_int = [](int x) { return x * 2; }; auto add_two_int = [](int x) { return x + 2; }; auto make_value = [](int x) { return Value{.number = x}; }; TEST(Result, TransformNonConstLValueRefInvokeSuccess) { Result r = 32; auto ret = r.transform(multiply_int); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, TransformNonConstLValueRefInvokeDifferentType) { Result r = 32; auto ret = r.transform(make_value); ASSERT_TRUE(ret.ok()); EXPECT_EQ(ret->number, 32); } TEST(Result, TransformNonConstLValueRefSkips) { Result r = Status::NotFound(); auto ret = r.transform(multiply_int); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, TransformNonConstRValueRefInvokeSuccess) { Result r = 32; auto ret = std::move(r).transform(multiply_int); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, TransformNonConstRValueRefInvokeDifferentType) { Result r = 32; auto ret = std::move(r).transform(make_value); ASSERT_TRUE(ret.ok()); EXPECT_EQ(ret->number, 32); } TEST(Result, TransformNonConstRValueRefSkips) { Result r = Status::NotFound(); auto ret = std::move(r).transform(multiply_int); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, TransformConstLValueRefInvokeSuccess) { const Result r = 32; auto ret = r.transform(multiply_int); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, TransformConstLValueRefInvokeDifferentType) { const Result r = 32; auto ret = r.transform(make_value); ASSERT_TRUE(ret.ok()); EXPECT_EQ(ret->number, 32); } TEST(Result, TransformConstLValueRefSkips) { const Result r = Status::NotFound(); auto ret = r.transform(multiply_int); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, TransformConstRValueRefInvokeSuccess) { const Result r = 32; auto ret = std::move(r).transform(multiply_int); ASSERT_TRUE(ret.ok()); EXPECT_EQ(*ret, 64); } TEST(Result, TransformConstRValueRefInvokeDifferentType) { const Result r = 32; auto ret = std::move(r).transform(make_value); ASSERT_TRUE(ret.ok()); EXPECT_EQ(ret->number, 32); } TEST(Result, TransformConstRValueRefSkips) { const Result r = Status::NotFound(); auto ret = std::move(r).transform(multiply_int); ASSERT_FALSE(ret.ok()); EXPECT_EQ(ret.status(), Status::NotFound()); } TEST(Result, TransformMultipleChained) { Result r = 32; auto ret = r.transform(multiply_int) .transform(add_two_int) .transform(multiply_int) .transform(make_value); ASSERT_TRUE(ret.ok()); EXPECT_EQ(ret->number, 132); } } // namespace } // namespace pw