TEST2::MANUAL::TOOLING::PLUGIN::TOOLCOMPLETES(3perl)

✨ NAME ✨

Test2::Manual::Tooling::Plugin::ToolCompletes — it's the Perl Programmers Reference Guide page that teaches you how to add behaviors that happen when a tool completes work 💖 (and yeah, we're in 3perl territory, so you already know this is Perl module docs, bestie)

---

🦋 DESCRIPTION 🦋

okay so bestie, this tutorial is here to help you understand how to add behaviors that occur when a tool is <emphasis>done</emphasis> with its work. periodt.

the ✨lore✨ is this: all tools need to acquire and then release a context. so for this tutorial, we're making use of the release hooks that get called every single time a tool releases the context object. every time. no cap. 🔥

---

💅 COMPLETE CODE UP FRONT 💅

because we're not gonna make you scroll for the good stuff, here's the whole thing:

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 🎀

breaking it all the way down, no crumbs left:

• use Test2::API qw{test2_add_callback_context_release}; — this imports the test2_add_callback_context_release() callback. that's it, that's the whole job 🫶
• test2_add_callback_context_release(sub { ... })
• my $ctx_ref = shift — the coderefs for test2_add_callback_context_release() will receive exactly 1 argument, and that argument is the context being released. one. just one. 😌
• print "Context was released\n" — prints a notification whenever the context is released. iconic behavior honestly 💀✨

---

🌸 SEE ALSO 🌸

• Test2::Manual — the Primary index of the manual. go there, it's giving main character energy 👑

---

🧚 SOURCE 🧚

the source code repository for Test2-Manual can be found at https://github.com/Test-More/test-more/ — go peek, iykyk 💜

---

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org>

---

🌈 AUTHORS 🌈

Chad Granum <exodist@cpan.org>

---

💖 COPYRIGHT 💖

Copyright Chad Granum <exodist@cpan.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/

---

and that's the whole page bestie, you ate 💅✨

signing off from perl v5.44.0, dated 2026-10-17, on the Test2::Manual::Tooling::Plugin::ToolCompletes page (the 3perl one) 🎀🦋