Stateful

@implicitNotFound("Could not find an implicit instance of Stateful[${F}, ${S}]. If you wish\nto ensure that the statefulness of this function is confined within this\nscope, you may want to construct a value of type StateT for this call-site,\nrather than ${F}. An example type:\n\n StateT[${F}, ${S}, *]\n\nIf you wish the state of ${S} to be threaded *through* this location, rather\nthan being scoped entirely within it, you should add an implicit parameter\nof this type to your function. For example:\n\n (implicit fstate: Stateful[${F}, ${S}])\n")
trait Stateful[F[_], S] extends Serializable

Stateful[F, S] is the capability to access and modify a state value from inside the F[_] context, using set(s: S): F[Unit] and get: F[S].

Stateful has four external laws:

def getThenSetDoesNothing = {
 get >>= set <-> pure(())
}
def setThenGetReturnsSetted(s: S) = {
 set(s) *> get <-> set(s) *> pure(s)
}
def setThenSetSetsLast(s1: S, s2: S) = {
 set(s1) *> set(s2) <-> set(s2)
}
def getThenGetGetsOnce = {
 get *> get <-> get
}

Stateful has two internal law:

def modifyIsGetThenSet(f: S => S) = {
 modify(f) <-> (inspect(f) flatMap set)
}

def inspectLaw[A](f: S => A) = {
 inspect(f) <-> (get map f)
}
Companion:
object
class Object
trait Matchable
class Any

Value members

Abstract methods

def get: F[S]
def monad: Monad[F]
def set(s: S): F[Unit]

Concrete methods

def inspect[A](f: S => A): F[A]
def modify(f: S => S): F[Unit]