NAME

Class::Workflow::Transition - A function over an instance.

SYNOPSIS

        package MyTransition;
        use Moose;
        with 'Class::Workflow::Transition';

DESCRIPTION

This is the base role for transition implementations.

every transition object must comply to it's interface, and furthermore must also use the "derive_and_accept_instance" method to return a derived instance at the end of the operation.

METHODS

derive_and_accept_instance $instance, \%attrs, @args

This method calls "$instance->derive" with the attrs, and then calls the instance "accept_instance" on the new instance's state.

%attrs must contain the key "state", which should do the role Class::Workflow::State.

@args are passed (along with the derived instance) to "accept_instance" in Class::Workflow::State.

REQUIRED METHODS

apply $insatnce, @args: This method accepts a Class::Workflow::Instance as it's first argument, and is expected to call "$self->derive_and_accept_instance( $instance, \%attrs, @args )", with %attrs containing the state that the instance is being transferred to (it doesn't have to be different than the current state).