trait EitherValues extends AnyRef
Trait that provides an implicit conversion that adds left.value
and right.value
methods
to Either
, which will return the selected value of the Either
if defined,
or throw TestFailedException
if not.
This construct allows you to express in one statement that an Either
should be left or right
and that its value should meet some expectation. Here's are some examples:
either1.right.value should be > 9 either2.left.value should be ("Muchas problemas")
Or, using assertions instead of matcher expressions:
assert(either1.right.value > 9) assert(either2.left.value === "Muchas problemas")
Were you to simply invoke right.get
or left.get
on the Either
,
if the Either
wasn't defined as expected (e.g., it was a Left
when you expected a Right
), it
would throw a NoSuchElementException
:
val either: Either[String, Int] = Left("Muchas problemas") either.right.get should be > 9 // either.right.get throws NoSuchElementException
The NoSuchElementException
would cause the test to fail, but without providing a stack depth pointing
to the failing line of test code. This stack depth, provided by TestFailedException
(and a
few other ScalaTest exceptions), makes it quicker for
users to navigate to the cause of the failure. Without EitherValues
, to get
a stack depth exception you would need to make two statements, like this:
val either: Either[String, Int] = Left("Muchas problemas") either should be ('right) // throws TestFailedException either.right.get should be > 9
The EitherValues
trait allows you to state that more concisely:
val either: Either[String, Int] = Left("Muchas problemas") either.right.value should be > 9 // either.right.value throws TestFailedException
- Source
- EitherValues.scala
- Alphabetic
- By Inheritance
- EitherValues
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
-
class
LeftValuable
[L, R] extends AnyRef
Wrapper class that adds a
value
method toLeftProjection
, allowing you to make statements like:Wrapper class that adds a
value
method toLeftProjection
, allowing you to make statements like:either.left.value should be > 9
-
class
RightValuable
[L, R] extends AnyRef
Wrapper class that adds a
value
method toRightProjection
, allowing you to make statements like:Wrapper class that adds a
value
method toRightProjection
, allowing you to make statements like:either.right.value should be > 9
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
clone(): AnyRef
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
implicit
def
convertLeftProjectionToValuable[L, R](leftProj: LeftProjection[L, R])(implicit pos: Position): LeftValuable[L, R]
Implicit conversion that adds a
value
method toLeftProjection
.Implicit conversion that adds a
value
method toLeftProjection
. -
implicit
def
convertRightProjectionToValuable[L, R](rightProj: RightProjection[L, R])(implicit pos: Position): RightValuable[L, R]
Implicit conversion that adds a
value
method toRightProjection
.Implicit conversion that adds a
value
method toRightProjection
. -
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
finalize(): Unit
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- AnyRef → Any
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )