NAME

Package::MoreUtil - Package-related utilities

VERSION

This document describes version 0.592 of Package::MoreUtil (from Perl distribution Package-MoreUtil), released on 2019-12-25.

SYNOPSIS

            

              
              
use Package::MoreUtil qw(
    package_exists
    list_package_contents
    list_package_subs
    list_subpackages
);
print "Package Foo::Bar exists" if package_exists("Foo::Bar");
my %content   = list_package_contents("Foo::Bar");
my @subnames  = list_package_subs("Foo::Bar");
my @subpkg    = list_subpackages("Foo::Bar");
my @allsubpkg = list_subpackages("Foo::Bar", 1); # recursive
            
          

DESCRIPTION

DEPRECATION NOTICE: This module is deprecated in favor of Package::Stash and Package::Util::Lite.

FUNCTIONS

package_exists($name) => BOOL

Return true if package "exists". By "exists", it means that the package has been defined by package statement or some entries have been created in the symbol table (e.g. $Foo::var = 1; will make the Foo package "exist").

This function can be used e.g. for checking before aliasing one package to another. Or to casually check whether a module has been loaded.

list_package_contents($name) => %res

Return a hash containing package contents. For example:

            

              
              
(
    sub1  => \&Foo::Bar::sub1,
    sub2  => \&Foo::Bar::sub2,
    '%h1' => \%Foo::Bar::h1,
    '@a1' => \@Foo::Bar::a1,
    ...
)
            
          

This module won't list subpackages. Use list_subpackages() for that.

list_package_subs($pkg) => @subnames

Return a list containing subroutine names in package $pkg.

list_subpackages($name[, $recursive]) => @res

List subpackages, e.g.:

            

              
              
(
    "Foo::Bar::Baz",
    "Foo::Bar::Qux",
    ...
)
            
          

If $recursive is true, will also list subpackages of subpackages, and so on.

FAQ

How to list all existing packages?

You can recurse from the top, e.g.:

            

              
              
list_subpackages("", 1);
            
          

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Package-MoreUtil.

SOURCE

Source repository is at https://github.com/perlancar/perl-Package-MoreUtil.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Package-MoreUtil

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

Package::Stash

Package::Util::Lite

perlmod

Package::Util (currently empty/placeholder at the time of this writing)

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019, 2018, 2014, 2013 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Package::MoreUtil

perl -MCPAN -e shell
install Package::MoreUtil