-
-
07 Feb 2020 07:44:31 UTC
- Distribution: parent
- Module version: 0.238
- Source (raw)
- Browse (raw)
- Changes
- How to Contribute
- Repository
- Issues (1)
- Testers (1403 / 0 / 0)
- Kwalitee
Bus factor: 5- 100.00% Coverage
- License: perl_5
- Perl: v5.6.0
- Activity
24 month- Tools
- Download (10.14KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- none
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
parent - Establish an ISA relationship with base classes at compile time
SYNOPSIS
package Baz; use parent qw(Foo Bar);
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
parent
not to load any modules by using the-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
require
would not consider an eligible filename (that is, it does not end in either.pm
or.pmc
), use the following code:package MySecondPlugin; require './plugins/custom.plugin'; # contains Plugin::Custom use parent -norequire, 'Plugin::Custom';
HISTORY
This module was forked from base to remove the cruft that had accumulated in it.
CAVEATS
SEE ALSO
- base
- parent::versioned
-
A fork of parent that provides version checking in parent class modules.
AUTHORS AND CONTRIBUTORS
Rafaël Garcia-Suarez, Bart Lateur, Max Maischein, Anno Siegel, Michael Schwern
MAINTAINER
Max Maischein
corion@cpan.org
Copyright (c) 2007-2017 Max Maischein
<corion@cpan.org>
Based on the idea ofbase.pm
, which was introduced with Perl 5.004_04.LICENSE
This module is released under the same terms as Perl itself.
Module Install Instructions
To install parent, copy and paste the appropriate command in to your terminal.
cpanm parent
perl -MCPAN -e shell install parent
For more information on module installation, please visit the detailed CPAN module installation guide.