Test2::Compare::Negatable(3p)

Test2::Compare::Negatable3p

Poor mans 'role' for compare objects that can be negated.

Overview

Using this package inside an Test2::Compare::Base subclass will overload "!$obj" and import clone_negate() and toggle_negate().

Why?

Until perl 5.18 the 'fallback' parameter to overload would not be inherited, so we cannot use inheritance for the behavior we actually want. This module works around the problem by emulating the "use overload" call we want for each consumer class.

Attributes

$bool = $obj->negate
$obj->set_negate($bool)
$attr = NEGATE()

The NEGATE attribute will be added via Test2::Util::HashBase.

Methods

$clone = $obj->clone_negate()

Create a shallow copy of the object, and call "toggle_negate" on it.

$obj->toggle_negate()

Toggle the negate attribute. If the attribute was on it will now be off, if it was off it will now be on.

Source

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

Maintainers

Chad Granum <[email protected]>

Releases

5 releases since OpenBSD 7.7; the text changed 2 times.

  1. 7.7–7.8
  2. 7.9
  3. 8.0

Authors

Chad Granum <[email protected]>

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's man source.