Gecko [ www.thearyasamaj.org ]

Name	Size	Permission
Constraint	[ DIR ]	drwxr-xr-x
Library	[ DIR ]	drwxr-xr-x
Role	[ DIR ]	drwxr-xr-x
Coercion.pm	8.12 KB	-rw-r--r--
Declare.pm	18.63 KB	-rw-r--r--
DeclaredAt.pm	3.12 KB	-rw-r--r--
Exception.pm	2.88 KB	-rw-r--r--
Exporter.pm	3.76 KB	-rw-r--r--
Helpers.pm	3.1 KB	-rw-r--r--
OO.pm	9.3 KB	-rw-r--r--
PartialDump.pm	5.76 KB	-rw-r--r--
Registry.pm	2.13 KB	-rw-r--r--
Subs.pm	6.37 KB	-rw-r--r--
TypeChecks.pm	1.91 KB	-rw-r--r--

Code Editor : Helpers.pm

package Specio::Helpers;

use strict;
use warnings;

use Carp qw( croak );
use Exporter 'import';
use overload ();

our $VERSION = '0.42';

use Scalar::Util qw( blessed );

our @EXPORT_OK = qw( install_t_sub is_class_loaded _STRINGLIKE );

sub install_t_sub {

# Specio::DeclaredAt use Specio::OO, which in turn uses
    # Specio::Helpers. If we load this with "use" we get a cirular require and
    # a big mess.
    require Specio::DeclaredAt;

my $caller = shift;
    my $types  = shift;

# XXX - check to see if their t() is something else entirely?
    return if $caller->can('t');

my $t = sub {
        my $name = shift;

croak 'The t subroutine requires a single non-empty string argument'
            unless _STRINGLIKE($name);

croak "There is no type named $name available for the $caller package"
            unless exists $types->{$name};

my $found = $types->{$name};

return $found unless @_;

my %p = @_;

croak 'Cannot parameterize a non-parameterizable type'
            unless $found->can('parameterize');

return $found->parameterize(
            declared_at => Specio::DeclaredAt->new_from_caller(1),
            %p,
        );
    };

{
        ## no critic (TestingAndDebugging::ProhibitNoStrict)
        no strict 'refs';
        no warnings 'redefine';
        *{ $caller . '::t' } = $t;
    }

return;
}

## no critic (Subroutines::ProhibitSubroutinePrototypes, Subroutines::ProhibitExplicitReturnUndef)
sub _STRINGLIKE ($) {
    return $_[0] if _STRING( $_[0] );

return $_[0]
        if blessed $_[0]
        && overload::Method( $_[0], q{""} )
        && length "$_[0]";

return undef;
}

# Borrowed from Params::Util
sub _STRING ($) {
    return defined $_[0] && !ref $_[0] && length( $_[0] ) ? $_[0] : undef;
}

# Borrowed from Types::Standard
sub is_class_loaded {
    my $stash = do {
        ## no critic (TestingAndDebugging::ProhibitNoStrict)
        no strict 'refs';
        \%{ $_[0] . '::' };
    };

return 1 if exists $stash->{ISA};
    return 1 if exists $stash->{VERSION};

foreach my $globref ( values %{$stash} ) {
        return 1
            if ref \$globref eq 'GLOB'
            ? *{$globref}{CODE}
            : ref $globref;    # const or sub ref
    }

return 0;
}

# ABSTRACT: Helper subs for the Specio distro

__END__

=pod

=encoding UTF-8

=head1 NAME

Specio::Helpers - Helper subs for the Specio distro

=head1 VERSION

version 0.42

=head1 DESCRIPTION

There's nothing public here.

=for Pod::Coverage .*

=head1 SUPPORT

Bugs may be submitted at L<https://github.com/houseabsolute/Specio/issues>.

I am also usually active on IRC as 'autarch' on C<irc://irc.perl.org>.

=head1 SOURCE

The source code repository for Specio can be found at L<https://github.com/houseabsolute/Specio>.

=head1 AUTHOR

Dave Rolsky <autarch@urth.org>

=head1 COPYRIGHT AND LICENSE

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)

The full text of the license can be found in the
F<LICENSE> file included with this distribution.

=cut

${this.title}

Code Editor : Helpers.pm