121 lines
3.0 KiB
Perl
121 lines
3.0 KiB
Perl
package attributes;
|
|
|
|
our $VERSION = 0.29;
|
|
|
|
@EXPORT_OK = qw(get reftype);
|
|
@EXPORT = ();
|
|
%EXPORT_TAGS = (ALL => [@EXPORT, @EXPORT_OK]);
|
|
|
|
use strict;
|
|
|
|
sub croak {
|
|
require Carp;
|
|
goto &Carp::croak;
|
|
}
|
|
|
|
sub carp {
|
|
require Carp;
|
|
goto &Carp::carp;
|
|
}
|
|
|
|
my %deprecated;
|
|
$deprecated{CODE} = qr/\A-?(locked)\z/;
|
|
$deprecated{ARRAY} = $deprecated{HASH} = $deprecated{SCALAR}
|
|
= qr/\A-?(unique)\z/;
|
|
|
|
my %msg = (
|
|
lvalue => 'lvalue attribute applied to already-defined subroutine',
|
|
-lvalue => 'lvalue attribute removed from already-defined subroutine',
|
|
const => 'Useless use of attribute "const"',
|
|
);
|
|
|
|
sub _modify_attrs_and_deprecate {
|
|
my $svtype = shift;
|
|
# Now that we've removed handling of locked from the XS code, we need to
|
|
# remove it here, else it ends up in @badattrs. (If we do the deprecation in
|
|
# XS, we can't control the warning based on *our* caller's lexical settings,
|
|
# and the warned line is in this package)
|
|
grep {
|
|
$deprecated{$svtype} && /$deprecated{$svtype}/ ? do {
|
|
require warnings;
|
|
warnings::warnif('deprecated', "Attribute \"$1\" is deprecated, " .
|
|
"and will disappear in Perl 5.28");
|
|
0;
|
|
} : $svtype eq 'CODE' && exists $msg{$_} ? do {
|
|
require warnings;
|
|
warnings::warnif(
|
|
'misc',
|
|
$msg{$_}
|
|
);
|
|
0;
|
|
} : 1
|
|
} _modify_attrs(@_);
|
|
}
|
|
|
|
sub import {
|
|
@_ > 2 && ref $_[2] or do {
|
|
require Exporter;
|
|
goto &Exporter::import;
|
|
};
|
|
my (undef,$home_stash,$svref,@attrs) = @_;
|
|
|
|
my $svtype = uc reftype($svref);
|
|
my $pkgmeth;
|
|
$pkgmeth = UNIVERSAL::can($home_stash, "MODIFY_${svtype}_ATTRIBUTES")
|
|
if defined $home_stash && $home_stash ne '';
|
|
my @badattrs;
|
|
if ($pkgmeth) {
|
|
my @pkgattrs = _modify_attrs_and_deprecate($svtype, $svref, @attrs);
|
|
@badattrs = $pkgmeth->($home_stash, $svref, @pkgattrs);
|
|
if (!@badattrs && @pkgattrs) {
|
|
require warnings;
|
|
return unless warnings::enabled('reserved');
|
|
@pkgattrs = grep { m/\A[[:lower:]]+(?:\z|\()/ } @pkgattrs;
|
|
if (@pkgattrs) {
|
|
for my $attr (@pkgattrs) {
|
|
$attr =~ s/\(.+\z//s;
|
|
}
|
|
my $s = ((@pkgattrs == 1) ? '' : 's');
|
|
carp "$svtype package attribute$s " .
|
|
"may clash with future reserved word$s: " .
|
|
join(' : ' , @pkgattrs);
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
@badattrs = _modify_attrs_and_deprecate($svtype, $svref, @attrs);
|
|
}
|
|
if (@badattrs) {
|
|
croak "Invalid $svtype attribute" .
|
|
(( @badattrs == 1 ) ? '' : 's') .
|
|
": " .
|
|
join(' : ', @badattrs);
|
|
}
|
|
}
|
|
|
|
sub get ($) {
|
|
@_ == 1 && ref $_[0] or
|
|
croak 'Usage: '.__PACKAGE__.'::get $ref';
|
|
my $svref = shift;
|
|
my $svtype = uc reftype($svref);
|
|
my $stash = _guess_stash($svref);
|
|
$stash = caller unless defined $stash;
|
|
my $pkgmeth;
|
|
$pkgmeth = UNIVERSAL::can($stash, "FETCH_${svtype}_ATTRIBUTES")
|
|
if defined $stash && $stash ne '';
|
|
return $pkgmeth ?
|
|
(_fetch_attrs($svref), $pkgmeth->($stash, $svref)) :
|
|
(_fetch_attrs($svref))
|
|
;
|
|
}
|
|
|
|
sub require_version { goto &UNIVERSAL::VERSION }
|
|
|
|
require XSLoader;
|
|
XSLoader::load();
|
|
|
|
1;
|
|
__END__
|
|
#The POD goes here
|
|
|