Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
Algorithm	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
App	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Archive	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Authen	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
CPAN	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Carp	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Config	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Data	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Date	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Digest	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Encode	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Error	[ DIR ]	drwxr-xr-x	2025-08-15 18:42
Exporter	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
ExtUtils	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
File	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Filter	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Getopt	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Git	[ DIR ]	drwxr-xr-x	2025-08-15 18:42
HTML	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
HTTP	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
IO	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
IPC	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
JSON	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
LWP	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Locale	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
MIME	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
MRO	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Math	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Module	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Mozilla	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Net	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Object	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
POD2	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Package	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Params	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Parse	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Perl	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
PerlIO	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Pod	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Software	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Sub	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
TAP	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Term	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Test	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Test2	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Text	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Thread	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Tie	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
Time	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Try	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
Types	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
WWW	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
autodie	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
inc	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
lib	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
libwww	[ DIR ]	drwxr-xr-x	2025-08-15 18:22
local	[ DIR ]	drwxr-xr-x	2025-08-15 18:07
CPAN.pm	144.4 KB	-rw-r--r--	2025-05-13 21:00
Carp.pm	35.12 KB	-rw-r--r--	2018-06-27 11:17
Digest.pm	10.96 KB	-rw-r--r--	2020-10-13 19:59
Env.pm	5.39 KB	-rw-r--r--	2013-03-02 17:10
Error.pm	29.45 KB	-rw-r--r--	2020-01-28 16:51
Expect.pm	98.09 KB	-rw-r--r--	2017-05-18 19:07
Exporter.pm	18.36 KB	-rw-r--r--	2019-11-18 22:21
Fatal.pm	57.7 KB	-rw-r--r--	2021-01-22 17:03
Git.pm	46.87 KB	-rw-r--r--	2025-07-21 16:27
Importer.pm	41.53 KB	-rw-r--r--	2020-08-16 21:24
LWP.pm	21.17 KB	-rw-r--r--	2021-03-07 16:54
Test2.pm	6.24 KB	-rw-r--r--	2020-10-22 03:10
TimeDate.pm	267 B	-rw-r--r--	2020-05-19 17:30
autodie.pm	12.14 KB	-rw-r--r--	2021-01-22 17:03
bigint.pm	22.85 KB	-rw-r--r--	2018-10-09 16:55
bignum.pm	20.64 KB	-rw-r--r--	2018-10-09 16:55
bigrat.pm	15.78 KB	-rw-r--r--	2018-10-09 16:55
constant.pm	14.38 KB	-rw-r--r--	2022-02-16 13:19
experimental.pm	7.39 KB	-rw-r--r--	2020-05-04 20:34
newgetopt.pl	2.15 KB	-rw-r--r--	2010-07-09 12:26
ok.pm	967 B	-rw-r--r--	2020-10-22 03:10
parent.pm	2.64 KB	-rw-r--r--	2020-02-07 07:43
perldoc.pod	9.16 KB	-rw-r--r--	2016-08-02 16:31
perlfaq.pm	77 B	-rw-r--r--	2021-05-20 04:16
perlfaq.pod	22.26 KB	-rw-r--r--	2021-05-20 04:16
perlfaq1.pod	14.09 KB	-rw-r--r--	2021-05-20 04:16
perlfaq2.pod	9.16 KB	-rw-r--r--	2021-05-20 04:16
perlfaq3.pod	36.72 KB	-rw-r--r--	2021-05-20 04:16
perlfaq4.pod	88.69 KB	-rw-r--r--	2021-05-20 04:16
perlfaq5.pod	54 KB	-rw-r--r--	2021-05-20 04:16
perlfaq6.pod	38.61 KB	-rw-r--r--	2021-05-20 04:16
perlfaq7.pod	36.93 KB	-rw-r--r--	2021-05-20 04:16
perlfaq8.pod	48.77 KB	-rw-r--r--	2021-05-20 04:16
perlfaq9.pod	14.86 KB	-rw-r--r--	2021-05-20 04:16
perlglossary.pod	134.02 KB	-rw-r--r--	2021-05-20 04:16
perlxs.pod	82.35 KB	-rw-r--r--	2022-02-16 08:56
perlxstut.pod	48.92 KB	-rw-r--r--	2022-02-16 08:56
perlxstypemap.pod	23.44 KB	-rw-r--r--	2022-02-16 08:56

Rename

package parent;
use strict;

our $VERSION = '0.238';

sub import {
    my $class = shift;

my $inheritor = caller(0);

if ( @_ and $_[0] eq '-norequire' ) {
        shift @_;
    } else {
        for ( my @filename = @_ ) {
            s{::|'}{/}g;
            require "$_.pm"; # dies if the file is not found
        }
    }

{
        no strict 'refs';
        push @{"$inheritor\::ISA"}, @_; # dies if a loop is detected
    };
};

__END__

=encoding utf8

=head1 NAME

parent - Establish an ISA relationship with base classes at compile time

=head1 SYNOPSIS

package Baz;
    use parent qw(Foo Bar);

=head1 DESCRIPTION

Allows you to both load one or more modules, while setting up inheritance from
those modules at the same time.  Mostly similar in effect to

package Baz;
    BEGIN {
        require Foo;
        require Bar;
        push @ISA, qw(Foo Bar);
    }

By default, every base class needs to live in a file of its own.
If you want to have a subclass and its parent class in the same file, you
can tell C<parent> not to load any modules by using the C<-norequire> switch:

package Foo;
  sub exclaim { "I CAN HAS PERL" }

package DoesNotLoadFooBar;
  use parent -norequire, 'Foo', 'Bar';
  # will not go looking for Foo.pm or Bar.pm

This is equivalent to the following code:

package Foo;
  sub exclaim { "I CAN HAS PERL" }

package DoesNotLoadFooBar;
  push @DoesNotLoadFooBar::ISA, 'Foo', 'Bar';

This is also helpful for the case where a package lives within
a differently named file:

package MyHash;
  use Tie::Hash;
  use parent -norequire, 'Tie::StdHash';

This is equivalent to the following code:

package MyHash;
  require Tie::Hash;
  push @ISA, 'Tie::StdHash';

If you want to load a subclass from a file that C<require> would
not consider an eligible filename (that is, it does not end in
either C<.pm> or C<.pmc>), use the following code:

package MySecondPlugin;
  require './plugins/custom.plugin'; # contains Plugin::Custom
  use parent -norequire, 'Plugin::Custom';

=head1 HISTORY

This module was forked from L<base> to remove the cruft
that had accumulated in it.

=head1 CAVEATS

=head1 SEE ALSO

=over 4

=item L<base>

=item L<parent::versioned>

A fork of L<parent> that provides version checking in parent class modules.

=back

=head1 AUTHORS AND CONTRIBUTORS

Rafaël Garcia-Suarez, Bart Lateur, Max Maischein, Anno Siegel, Michael Schwern

=head1 MAINTAINER

Max Maischein C< corion@cpan.org >

Copyright (c) 2007-2017 Max Maischein C<< <corion@cpan.org> >>
Based on the idea of C<base.pm>, which was introduced with Perl 5.004_04.

=head1 LICENSE

This module is released under the same terms as Perl itself.

=cut