File Coverage

blib/lib/Data/Hopen/Class.pm

Criterion	Covered	Total	%
statement	29	29	100.0
branch	10	10	100.0
condition	6	6	100.0
subroutine	7	7	100.0
pod	1	1	100.0
total	53	53	100.0

# Data::Hopen::Class - Class::Tiny base class supporting new(-arg => value)
package Data::Hopen::Class;

use 5.006;
use strict;
use warnings;
use Carp qw(croak);

our $VERSION = '0.000019';

# No parent, so Class::Tiny will become the parent
use Class::Tiny;

# Docs {{{1

=head1 NAME

Data::Hopen::Class - Class::Tiny base class supporting C<< new(-arg => value) >>

=head1 SYNOPSIS

This is the same as L except for a custom C method
that permits you to put hyphens in front of the argument names in the
constructor call.  This provides consistency with L.

=cut

# }}}1

=head1 FUNCTIONS

=head2 BUILDARGS

Pre-process the constructor arguments to strip leading hyphens from
argument names.

Note: L prohibits attributes named C<-> (a single hyphen),
so we don't handle that case.

=cut

# The internal builder, so I don't have to worry about dispatch
# once our BUILDARGS is called.

sub _data_hopen_class_builder_internal {
    my $class = shift or croak 'Need a class';

    if(@_ == 1 && ref $_[0] eq 'HASH') {
        @_ = ($class, %{$_[0]});
        goto \&_data_hopen_class_builder_internal;
            # No extra stack frame for the sake of croak()
    } elsif(@_ == 1 && ref $_[0]) {
        croak "$class\->new(arg) with @{[ref $_[0]]} instead of HASH ref";
    } elsif(@_ % 2) {
        croak "Odd number of arguments to $class\->new()";
    }

    # Now we have key-value pairs.  Trim leading hyphens on the keys.
    my %args = @_;
    for (keys %args) {
        next unless /^-/;
        $args{ substr $_, 1 } = $args{ $_ };
        delete $args{ $_ };
    }

    return \%args;
};  # $_builder()

sub BUILDARGS {
    goto \&Data::Hopen::Class::_data_hopen_class_builder_internal;
} #BUILDARGS()

1;
__END__