object Retries extends Retries
Companion object to trait Retries that enables its members to be imported as an
alternative to mixing them in.
- Source
- Retries.scala
- Alphabetic
- By Inheritance
- Retries
- Retries
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
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[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- def isRetryable(testData: TestData): Boolean
Indicates whether the test described by the given
TestDataincludes the tagorg.scalatest.tags.Retryable.Indicates whether the test described by the given
TestDataincludes the tagorg.scalatest.tags.Retryable.This method provides an easy way to selectively retry just tests that are flickering. You can annotated such problematic tests with
Retryable, and just retry those. Here's what it might look like:override def withFixture(test: NoArgTest) = { if (isRetryable(test)) withRetry { super.withFixture(test) } else super.withFixture(test) }
- Definition Classes
- Retries
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- 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(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- def withRetry(delay: Span)(blk: => Outcome): Outcome
Retries the given block with a given delay if the
Outcomeof executing the block is eitherFailedorCanceled.Retries the given block with a given delay if the
Outcomeof executing the block is eitherFailedorCanceled.The behavior of this method is defined in the table below. The first two rows show the main "retry" behavior: if executing the block initially fails, and on retry it succeeds, the result is
Canceled. The purpose of this is to deal with "flickering" tests by downgrading a failure that succeeds on retry to a cancelation. Or, if executing the block initially results inCanceled, and on retry it succeeds, the result isSucceeded. The purpose of this is to deal with tests that intermittently cancel by ignoring a cancelation that succeeds on retry.In the table below, if the “Retry
Outcome” has just a dash, the block is not retried. Otherwise, the block is retried on the same thread, after sleeping the given delay.First OutcomeRetry OutcomeResult FailedSucceededCanceled(theSucceededandFailedare discarded; the exception from theFailedis the cause of the exception in theCanceled)CanceledSucceededSucceeded(theCanceledis discarded)Succeeded— Succeeded(no retry)Pending— Pending(no retry)FailedFailedthe first Failed(the secondFailedis discarded)FailedPendingthe Failed(thePendingis discarded)FailedCanceledthe Failed(theCanceledis discarded)CanceledCanceledthe first Canceled(the secondCanceledis discarded)CanceledPendingthe Canceled(thePendingis discarded)CanceledFailedthe Failed(theCanceledis discarded)- delay
the amount of time to sleep before retrying
- blk
the block to execute and potentially retry
- Definition Classes
- Retries
- def withRetry(blk: => Outcome): Outcome
Retries the given block immediately (with no delay) if the
Outcomeof executing the block is eitherFailedorCanceled.Retries the given block immediately (with no delay) if the
Outcomeof executing the block is eitherFailedorCanceled.The behavior of this method is defined in the table below. The first two rows show the main "retry" behavior: if executing the block initially fails, and on retry it succeeds, the result is
Canceled. The purpose of this is to deal with "flickering" tests by downgrading a failure that succeeds on retry to a cancelation. Or, if executing the block initially results inCanceled, and on retry it succeeds, the result isSucceeded. The purpose of this is to deal with tests that intermittently cancel by ignoring a cancelation that succeeds on retry.In the table below, if the “Retry
Outcome” has just a dash, the block is not retried. Otherwise, the block is retried on the same thread, with no delay.First OutcomeRetry OutcomeResult FailedSucceededCanceled(theSucceededandFailedare discarded; the exception from theFailedis the cause of the exception in theCanceled)CanceledSucceededSucceeded(theCanceledis discarded)Succeeded— Succeeded(no retry)Pending— Pending(no retry)FailedFailedthe first Failed(the secondFailedis discarded)FailedPendingthe Failed(thePendingis discarded)FailedCanceledthe Failed(theCanceledis discarded)CanceledCanceledthe first Canceled(the secondCanceledis discarded)CanceledPendingthe Canceled(thePendingis discarded)CanceledFailedthe Failed(theCanceledis discarded)- blk
the block to execute and potentially retry
- Definition Classes
- Retries
- def withRetryOnCancel(delay: Span)(blk: => Outcome): Outcome
Retries the given block after the given delay if the
Outcomeof executing the block isCanceled.Retries the given block after the given delay if the
Outcomeof executing the block isCanceled.The behavior of this method is defined in the table below. The first row shows the main "retry" behavior: if executing the block initially results in
Canceled, and on retry it succeeds, the result isSucceeded. The purpose of this is to deal with tests that intermittently cancel by ignoring a cancelation that succeeds on retry.In the table below, if the “Retry
Outcome” has just a dash, the block is not retried. Otherwise, the block is retried on the same thread, after the given delay.First OutcomeRetry OutcomeResult CanceledSucceededthe Succeeded(theCanceledis discarded)Succeeded— Succeeded(no retry)Pending— Pending(no retry)Failed— Failed(no retry)CanceledCanceledthe first Canceled(the secondCanceledis discarded)CanceledPendingthe Canceled(thePendingis discarded)CanceledFailedthe Failed(theCanceledis discarded)- delay
the amount of time to sleep before retrying
- blk
the block to execute and potentially retry
- Definition Classes
- Retries
- def withRetryOnCancel(blk: => Outcome): Outcome
Retries the given block immediately (with no delay) if the
Outcomeof executing the block isCanceled.Retries the given block immediately (with no delay) if the
Outcomeof executing the block isCanceled.The behavior of this method is defined in the table below. The first row shows the main "retry" behavior: if executing the block initially results in
Canceled, and on retry it succeeds, the result isSucceeded. The purpose of this is to deal with tests that intermittently cancel by ignoring a cancelation that succeeds on retry.In the table below, if the “Retry
Outcome” has just a dash, the block is not retried. Otherwise, the block is retried on the same thread, with no delay.First OutcomeRetry OutcomeResult CanceledSucceededthe Succeeded(theCanceledis discarded)Succeeded— Succeeded(no retry)Pending— Pending(no retry)Failed— Failed(no retry)CanceledCanceledthe first Canceled(the secondCanceledis discarded)CanceledPendingthe Canceled(thePendingis discarded)CanceledFailedthe Failed(theCanceledis discarded)- blk
the block to execute and potentially retry
- Definition Classes
- Retries
- def withRetryOnFailure(delay: Span)(blk: => Outcome): Outcome
Retries the given block immediately with the given delay if the
Outcomeof executing the block isFailed.Retries the given block immediately with the given delay if the
Outcomeof executing the block isFailed.The behavior of this method is defined in the table below. The first row shows the main "retry" behavior: if executing the block initially fails, and on retry it succeeds, the result is
Canceled. The purpose of this is to deal with "flickering" tests by downgrading a failure that succeeds on retry to a cancelation.In the table below, if the “Retry
Outcome” has just a dash, the block is not retried. Otherwise, the block is retried on the same thread, after the given delay.First OutcomeRetry OutcomeResult FailedSucceededCanceled(theSucceededandFailedare discarded; the exception from theFailedis the cause of the exception in theCanceled)Succeeded— Succeeded(no retry)Pending— Pending(no retry)Canceled— the Canceled(no retry)FailedFailedthe first Failed(the secondFailedis discarded)FailedPendingthe Failed(thePendingis discarded)FailedCanceledthe Failed(theCanceledis discarded)- delay
the amount of time to sleep before retrying
- blk
the block to execute and potentially retry
- Definition Classes
- Retries
- def withRetryOnFailure(blk: => Outcome): Outcome
Retries the given block immediately (with no delay) if the
Outcomeof executing the block isFailed.Retries the given block immediately (with no delay) if the
Outcomeof executing the block isFailed.The behavior of this method is defined in the table below. The first row shows the main "retry" behavior: if executing the block initially fails, and on retry it succeeds, the result is
Canceled. The purpose of this is to deal with "flickering" tests by downgrading a failure that succeeds on retry to a cancelation.In the table below, if the “Retry
Outcome” has just a dash, the block is not retried. Otherwise, the block is retried on the same thread, with no delay.First OutcomeRetry OutcomeResult FailedSucceededCanceled(theSucceededandFailedare discarded; the exception from theFailedis the cause of the exception in theCanceled)Succeeded— Succeeded(no retry)Pending— Pending(no retry)Canceled— the Canceled(no retry)FailedFailedthe first Failed(the secondFailedis discarded)FailedPendingthe Failed(thePendingis discarded)FailedCanceledthe Failed(theCanceledis discarded)- blk
the block to execute and potentially retry
- Definition Classes
- Retries