README
1NAME
2 Package::Util::Lite - Package-related utilities
3
4VERSION
5 This document describes version 0.001 of Package::Util::Lite (from Perl
6 distribution Package-Util-Lite), released on 2019-01-06.
7
8SYNOPSIS
9 use Package::Util::Lite qw(
10 package_exists
11 list_subpackages
12 );
13
14 print "Package Foo::Bar exists" if package_exists("Foo::Bar");
15
16 my @subpkg = list_subpackages("Foo::Bar");
17 my @allsubpkg = list_subpackages("Foo::Bar", 1); # recursive
18
19DESCRIPTION
20 This module provides package-related utilities. You should check
21 Package::Stash first, then here.
22
23FUNCTIONS
24 package_exists
25 Usage:
26
27 package_exists($name) => bool
28
29 Return true if package "exists". By "exists", it means that the package
30 has been defined by "package" statement or some entries have been
31 created in the symbol table (e.g. "$Foo::var = 1;" will make the "Foo"
32 package "exist").
33
34 This function can be used e.g. for checking before aliasing one package
35 to another. Or to casually check whether a module has been loaded.
36
37 list_subpackages($name[, $recursive]) => @res
38 List subpackages, e.g.:
39
40 (
41 "Foo::Bar::Baz",
42 "Foo::Bar::Qux",
43 ...
44 )
45
46 If $recursive is true, will also list subpackages of subpackages, and so
47 on.
48
49FAQ
50HOMEPAGE
51 Please visit the project's homepage at
52 <https://metacpan.org/release/Package-Util-Lite>.
53
54SOURCE
55 Source repository is at
56 <https://github.com/perlancar/perl-Package-Util-Lite>.
57
58BUGS
59 Please report any bugs or feature requests on the bugtracker website
60 <https://rt.cpan.org/Public/Dist/Display.html?Name=Package-Util-Lite>
61
62 When submitting a bug or request, please include a test-file or a patch
63 to an existing test-file that illustrates the bug or desired feature.
64
65SEE ALSO
66 Package::Stash
67
68AUTHOR
69 perlancar <perlancar@cpan.org>
70
71COPYRIGHT AND LICENSE
72 This software is copyright (c) 2019 by perlancar@cpan.org.
73
74 This is free software; you can redistribute it and/or modify it under
75 the same terms as the Perl 5 programming language system itself.
76
77