Acme-Parataxis

 view release on metacpan or  search on metacpan

lib/Acme/Parataxis/CancellationToken.pm  view on Meta::CPAN

use v5.40;
no warnings 'experimental::class', 'recursion';
use feature 'class';
#
class Acme::Parataxis::CancellationToken v0.1.3 {
    use Acme::Parataxis;
    use Carp        qw[croak];
    use Time::HiRes qw[time];

    # $kind selects which error an interrupted waiter throws. Public tokens use 'cancel'; with_timeout's internal
    # deadline token uses 'timeout' so the same mechanism raises Timeout instead of Cancelled.
    field $cancelled : reader : param = false;
    field $kind      : reader : param = 'cancel';
    field $t0        : reader = time;    # token birth, for elapsed-time tracing

    # Fiber ids currently parked under this token, in registration order. cancel() wakes them; unregister()/the
    # on_wake( { ... } ) cleanup removes them when their wait finishes normally.
    field @registered;

    method register () {
        my $fid = Acme::Parataxis->current_fid;
        croak 'register() must be called from inside a scheduled fiber' if $fid < 0;
        if ($cancelled) {    # too late to wait in vain: the next parked wait throws immediately on its wake
            Acme::Parataxis::_interrupt( $fid, $kind );
            return $fid;
        }
        push @registered, $fid if !grep { $_ == $fid } @registered;
        return $fid;
    }

    method unregister () {    # Remove the current fiber from the token. Safe to call any number of times.
        my $fid = Acme::Parataxis->current_fid;
        @registered = grep { $_ != $fid } @registered;
        return $fid;
    }

    method cancel () {        # Idempotent: flips the flag, wakes every registered (parked) fiber with an interrupt.
        return if $cancelled;
        my @fids = @registered;
        $cancelled  = true;
        @registered = ();
        warn sprintf "PARATAXIS_TRACE t=%.0fms(age=%.0fms) token cancel kind=%s fids=%s states=%s\n", ( time - $^T ) * 1000, ( time - $t0 ) * 1000,
            $kind, join( ',', @fids ), join(
            ',',
            map {
                my $fb = Acme::Parataxis->by_id($_);
                $fb ? ( $fb->is_done ? "f$_:done" : 'f' . $_ . ':' . ( $fb->wait_reason ? $fb->wait_reason->[0] : 'run' ) ) : "f$_:gone"
            } @fids
            ) if $ENV{PARATAXIS_TRACE};
        Acme::Parataxis::_interrupt( $_, $kind ) for @fids;
        return true;
    }
    method waiters () { return scalar @registered }
};
#
1;



( run in 1.488 second using v1.01-cache-2.11-cpan-234fa220139 )