—

              
package Specio::Helpers;
use strict;
use warnings;
use Carp qw( croak );
use Exporter 'import';
use overload ();
our $VERSION = '0.50';
use Scalar::Util qw( blessed );
our @EXPORT_OK = qw( install_t_sub is_class_loaded perlstring _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?
    {
        ## no critic (TestingAndDebugging::ProhibitNoStrict)
        no strict 'refs';
        # We used to check ->can('t') but that was wrong, since it would
        # return if a parent class had a t() sub.
        return if *{ $caller . '::t' }{CODE};
    }
    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;
}
BEGIN {
    if ( $] >= 5.010 && eval { require XString; 1 } ) {
        *perlstring = \&XString::perlstring;
    }
    else {
        require B;
        *perlstring = \&B::perlstring;
    }
}
# 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;
}
1;
# ABSTRACT: Helper subs for the Specio distro
__END__
HideShow 43 lines of Pod
=pod
=encoding UTF-8
=head1 NAME
Specio::Helpers - Helper subs for the Specio distro
=head1 VERSION
version 0.50
=head1 DESCRIPTION
There's nothing public here.
=for Pod::Coverage .*
=head1 SUPPORT
Bugs may be submitted at L<https://github.com/houseabsolute/Specio/issues>.
=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 software is Copyright (c) 2012 - 2025 by Dave Rolsky.
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