File Coverage

blib/lib/Iterator/Flex/Method.pm

Criterion	Covered	Total	%
statement	35	35	100.0
branch	2	2	100.0
condition			n/a
subroutine	10	10	100.0
pod			n/a
total	47	47	100.0

package Iterator::Flex::Method;

# ABSTRACT: Compartmentalize Iterator::Flex::Method::Maker

use v5.28;
use strict;
use warnings;
use experimental 'signatures';

our $VERSION = '0.34';

# Package::Variant based modules generate constructor functions
# dynamically when those modules are imported.  However, loading the
# module via require() then calling its import method must be done
# only once, otherwise Perl will emit multiply defined errors for the
# constructor functions.

# By layering the Package::Variant based module in an inner package
# and calling its import here, the constructor function, Maker(), is
# generated just once, as Iterator::Flex::Method::Maker, and is
# available to any caller by it's fully qualified name.

Iterator::Flex::Method::Maker->import;

## no critic( MultiplePackages )
package Iterator::Flex::Method::Maker {

    use Iterator::Flex::Utils qw( :default REG_ITERATOR REG_ITER_METHODS );
    use Package::Variant importing => qw[ Role::Tiny ];
    use Module::Runtime;

    sub make_variant_package_name ( $, $package, % ) {

        $package = "Iterator::Flex::Role::Method::$package";

        if ( Role::Tiny->is_role( $package ) ) {
            require Iterator::Flex::Failure;
            Iterator::Flex::Failure::RoleExists->throw( { payload => $package } );
        }

        ## no critic (Require LocalizedPunctuationVars )
        $INC{ Module::Runtime::module_notional_filename( $package ) } = 1;
        return $package;
    }

    sub make_variant ( $, $, $, %arg ) {
        my $name = $arg{name};
        install $name => sub {
            return $REGISTRY{ refaddr $_[0] }[REG_ITERATOR][REG_ITER_METHODS]{$name}->( @_ );
        };
    }
}

1;

#
# This file is part of Iterator-Flex
#
# This software is Copyright (c) 2018 by Smithsonian Astrophysical Observatory.
#
# This is free software, licensed under:
#
#   The GNU General Public License, Version 3, June 2007
#

__END__