[add-getRight-and-getLeft-methods] Added asRight() assertion to EitherAssert

Author: rcardin

src/main/kotlin/in/rcard/assertj/arrowcore/AbstractEitherAssert.kt

@@ -1,13 +1,15 @@
 package `in`.rcard.assertj.arrowcore
 
 import arrow.core.Either
+import arrow.core.Option
 import `in`.rcard.assertj.arrowcore.errors.EitherShouldBeLeft.Companion.shouldBeLeft
 import `in`.rcard.assertj.arrowcore.errors.EitherShouldBeRight.Companion.shouldBeRight
 import `in`.rcard.assertj.arrowcore.errors.EitherShouldContain.Companion.shouldContainOnLeft
 import `in`.rcard.assertj.arrowcore.errors.EitherShouldContain.Companion.shouldContainOnRight
 import `in`.rcard.assertj.arrowcore.errors.EitherShouldContainInstanceOf.Companion.shouldContainOnLeftInstanceOf
 import `in`.rcard.assertj.arrowcore.errors.EitherShouldContainInstanceOf.Companion.shouldContainOnRightInstanceOf
 import org.assertj.core.api.AbstractObjectAssert
+import org.assertj.core.api.Assertions
 import org.assertj.core.internal.ComparisonStrategy
 import org.assertj.core.internal.StandardComparisonStrategy
 
@@ -100,6 +102,18 @@ abstract class AbstractEitherAssert<
         return myself
     }
 
+    /**
+     * Verifies that the actual [Either] is not null and contains a right-sided value and returns an Object assertion
+     * that allows chaining (object) assertions on the value.
+     *
+     * @since 0.2.0
+     * @return a new [AbstractObjectAssert] for assertions chaining on the right-sided value of the [Either].
+     */
+    fun asRight(): AbstractObjectAssert<*, RIGHT> {
+        assertIsRight()
+        return Assertions.assertThat(actual.getOrNull())
+    }
+
     private fun assertIsRight() {
         isNotNull
         if (!actual.isRight()) {

src/test/kotlin/in/rcard/assertj/arrowcore/EitherAssert_asRight_Test.kt

@@ -0,0 +1,35 @@
+package `in`.rcard.assertj.arrowcore
+
+import arrow.core.Either
+import arrow.core.left
+import arrow.core.right
+import `in`.rcard.assertj.arrowcore.EitherAssert.Companion.assertThat
+import `in`.rcard.assertj.arrowcore.errors.EitherShouldBeRight.Companion.shouldBeRight
+import org.assertj.core.api.Assertions
+import org.assertj.core.util.FailureMessages
+import org.junit.jupiter.api.Test
+
+internal class EitherAssert_asRight_Test {
+
+    @Test
+    internal fun `should return a valid Object assert if the either contains a right-sided value`() {
+        val actualRightValue: Either<Nothing, Int> = 42.right()
+        assertThat(actualRightValue).asRight().isEqualTo(42)
+    }
+
+    @Test
+    internal fun `should fail if the either contains a left-sided value`() {
+        val actualLeftValue: Either<String, Nothing> = "42".left()
+        Assertions.assertThatThrownBy { assertThat(actualLeftValue).asRight() }
+            .isInstanceOf(AssertionError::class.java)
+            .hasMessage(shouldBeRight(actualLeftValue).create())
+    }
+
+    @Test
+    internal fun `should fail if the either is null`() {
+        val actualRightValue: Either<Nothing, Int>? = null
+        Assertions.assertThatThrownBy { assertThat(actualRightValue).asRight() }
+            .isInstanceOf(AssertionError::class.java)
+            .hasMessage(FailureMessages.actualIsNull())
+    }
+}