/usr/share/perl5/Class/Inner.pm is in libclass-inner-perl 0.200001-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 | package Class::Inner;
use vars qw/$VERSION/;
$VERSION = 0.200_001;
use strict;
use Carp;
=head1 NAME
Class::Inner - A perlish implementation of Java like inner classes
=head1 SYNOPSIS
use Class::Inner;
my $object = Class::Inner->new(
parent => 'ParentClass',
methods => { method => sub { ... } }, },
constructor => 'new',
args => [@constructor_args],
);
=head1 DESCRIPTION
Yet another implementation of an anonymous class with per object
overrideable methods, but with the added attraction of sort of working
dispatch to the parent class's method.
=head2 METHODS
=over 4
=item B<new HASH>
Takes a hash like argument list with the following keys.
=over 4
=item B<parent>
The name of the parent class. Note that you can only get single
inheritance with this or B<SUPER> won't work.
=item B<methods>
A hash, keys are method names, values are CODEREFs.
=item B<constructor>
The name of the constructor method. Defaults to 'new'.
=item B<args>
An anonymous array of arguments to pass to the constructor. Defaults
to an empty list.
=back
Returns an object in an 'anonymous' class which inherits from the
parent class. This anonymous class has a couple of 'extra' methods:
=over 4
=item B<SUPER>
If you were to pass something like
$obj = Class::Inner->new(
parent => 'Parent',
methods => { method => sub { ...; $self->SUPER::method(@_) } },
);
then C<$self-C<gt>SUPER::method> almost certainly wouldn't do what you expect,
so we provide the C<SUPER> method which dispatches to the parent
implementation of the current method. There seems to be no good way of
getting the full C<SUPER::> functionality, but I'm working on it.
=item B<DESTROY>
Because B<Class::Inner> works by creating a whole new class name for your
object, it could potentially leak memory if you create a lot of them. So we
add a C<DESTROY> method that removes the class from the symbol table once
it's finished with.
If you need to override a parent's DESTROY method, adding a call to
C<Class::Inner::clean_symbol_table(ref $self)> to it. Do it at the
end of the method or your other method calls won't work.
=back
=cut
#'
sub new {
my $class = shift;
my %args = ref($_[0]) ? %{$_[0]} : @_;
my $parent = $args{parent} or
croak "Can't work without a parent class\n";
my %methods = %{$args{methods}||{}};
my $constructor = $args{constructor} || 'new';
my @constructor_args = @{$args{args} || []};
my $anon_class = $class->new_classname;
no strict 'refs';
@{"$anon_class\::ISA"} = $parent;
foreach my $methodname (keys %methods) {
*{"$anon_class\::$methodname"} = sub {
local $Class::Inner::target_method = $methodname;
$methods{$methodname}->(@_);
};
}
# Add the SUPER method.
unless (exists $methods{SUPER}) {
*{"$anon_class\::SUPER"} = sub {
my $self = shift;
my $target_method =
join '::', $parent, $Class::Inner::target_method;
$self->$target_method(@_);
};
}
unless (exists $methods{DESTROY}) {
*{"$anon_class\::DESTROY"} = sub {
my $self = shift;
Class::Inner::clean_symbol_table($anon_class);
bless $self, $parent;
}
}
# Instantiate
my $obj = $anon_class->new(@constructor_args);
}
=item B<clean_symbol_table>
The helper subroutine that DESTROY uses to remove the class from the
symbol table.
=cut
sub clean_symbol_table {
my $class = shift;
no strict 'refs';
undef %{"${class}::"};
}
=item B<new_classname>
Returns a name for the next anonymous class.
=cut
{
my $class_counter;
sub new_classname {
my $baseclass = shift;
return "$baseclass\::__A" . $class_counter++;
}
}
1;
__END__
=back
=head1 AUTHOR
Maintained by Arun Prasaad C<< <arunbear@cpan.org> >>
Copyright (c) 2001 by Piers Cawley E<lt>pdcawley@iterative-software.comE<gt>.
All rights reserved. This program is free software; you can redistribute it
and/or modify it under the same terms as perl itself.
Thanks to the Iterative Software people: Leon Brocard, Natalie Ford and
Dave Cross. Also, this module was written initially for use in the
PerlUnit project, AKA Test::Unit. Kudos to Christian Lemburg and the rest
of that team.
=head1 SEE ALSO
There are a million and one differen Class constructors available on CPAN,
none of them does quite what I want, so I wrote this one to add to
that population where hopefully it will live and thrive.
=head1 BUGS
Bound to be some. Actually the C<SUPER> method is a workaround for what
I consider to be a bug in perl.
|