Test2::Manual::Tooling::Plugin::ToolCompletes(3pm)

Test2::Manual::Tooling::Plugin::ToolCompletes3pm

How to add behaviors that occur when a tool completes work.

Overview

This tutorial helps you understand how to add behaviors that occur when a tool is done with its work. All tools need to acquire and then release a context, for this tutorial we make use of the release hooks that are called every time a tool releases the context object.

Complete code up front

    package Test2::Plugin::MyPlugin;
    use Test2::API qw{test2_add_callback_context_release};
    sub import {
        my $class = shift;
        test2_add_callback_context_release(sub {
            my $ctx_ref = shift;
            print "Context was released\n";
        });
    }
    1;

Line by line

use Test2::API qw{test2_add_callback_context_release};

This imports the test2_add_callback_context_release() callback.

test2_add_callback_context_release(sub { ... })
my $ctx_ref = shift

The coderefs for test2_add_callback_context_release() will receive exactly 1 argument, the context being released.

print "Context was released\n"

Print a notification whenever the context is released.

Source

The source code repository for Test2-Manual can be found at https://github.com/Test-More/test-more/.

Maintainers

Chad Granum <[email protected]>

Releases

4 releases since Debian 10 (Buster); the text changed 3 times.

  1. 10
  2. 11
  3. 12
  4. 13

Authors

Chad Granum <[email protected]>

From libtest-simple-perl 1.302210-1 in Debian 13 (Trixie). Also shipped by libtest2-suite-perl. Parsed by carta from the page's man source.