final case class LocalSoftDeadline[-I, +O, +E](tsSupplier: () =>Long, now: () =>Long, duration: Long, alterand: Stage[I, O, E]) extends Decorator[I, O, E]
A decorator that stops the pipeline when a time budget measured from the beginning of the current unit of work is exhausted.
Unlike h8io.stages.std.GlobalSoftDeadline, which measures time from the moment the stage is created and never resets, LocalSoftDeadline measures time from the apply call that started the current unit of work: the timestamp is captured at that call and preserved for as long as the evolution is invoked with h8io.stages.Status.Success. When the evolution is invoked with any other status, the clock is reset — the new window starts at the next apply call. The same reset happens after the deadline has been exceeded.
The deadline is ''soft'': it is checked after the inner stage has already been applied. If it is exceeded, a h8io.stages.Status.Success in the current h8io.stages.Yield is upgraded to an errorless h8io.stages.Status.Complete; any other status is left unchanged.
If duration ≤ 0 the factory methods return h8io.stages.std.DeadEnd directly, ensuring the pipeline immediately terminates.
Type parameters
E
the error type (covariant)
I
the input type (contravariant)
O
the output type (covariant)
Value parameters
alterand
the inner stage whose deadline is enforced
duration
the time budget in nanoseconds
now
a supplier of the current time in nanoseconds
tsSupplier
a thunk that returns the timestamp of the start of the current deadline window
Returns this stage's Evolution without consuming an input.
Returns this stage's Evolution without consuming an input.
Called instead of apply whenever the stage takes part in a run but has nothing to process: the upstream yielded no output, or a binary operator excluded this branch. The evolution must be the one the stage would have returned had it run. Like apply, skip() may perform side effects — a decorator, for instance, may advance or release the inner stage it owns.
Composes this stage with that, feeding this stage's output into it. See the ''Composition'' section above for what happens when there is no output to feed.
Composes this stage with that, feeding this stage's output into it. See the ''Composition'' section above for what happens when there is no output to feed.