1SCAN-PERL-PREREQS-NQLITUEs(e1r)Contributed Perl DocumentSaCtAiNo-nPERL-PREREQS-NQLITE(1)
2
3
4

NAME

6       scan-perl-prereqs-nqlite
7

SYNOPSIS

9         scan-perl-prereqs-nqlite [DIRS|FILES]
10

DESCRIPTION

12       "scan-perl-prereqs-nqlite" traverses several files and subdirectories
13       in the current directory with File::Find to collect all ".pl", ".PL",
14       ".pm", ".t", ".psgi" files (as well as all the files in "scripts?" and
15       "bin" directories), and prints a single combined list of prerequisites,
16       which should be suitable for piping to "cpanm" or similar tools.
17
18       You can also pass files and/or directories to limit files to scan.  In
19       this case, however, "scan-perl-prereqs-nqlite" may fail to exclude
20       modules that should belong to the same distribution.
21

OPTIONS

23       version
24           Show the version.
25
26       help
27           Show this help.
28
29       json
30           Print prerequisites as a JSON if JSON::PP is installed.
31
32       cpanfile, save_cpanfile
33           Print prerequisites as "cpanfile" if Module::CPANfile is installed.
34           If "safe-cpanfile" is set, create or update "cpanfile".
35
36       suggests
37           Print suggestions ("use"d modules in "eval") as well.
38
39       develop
40           Print requirements/suggestions for developers ("use"d modules in
41           "xt" and "author" directories) as well.
42
43       perl_minimum_version
44           May modify required perl version if new language features are used
45           without declaring the required perl version explicitly.
46
47       exclude_core
48           Ignore prerequisites that are bundled with Perl (of 5.008001 by
49           default). This requires Module::CoreList version 2.99 or above.
50
51       perl_version
52           Ignore prerequisites that are bundled with Perl of a specific
53           version. This implies "exclude-core" as well.
54
55       allow_test_pms
56           Print requirements/suggestions in .pm files that are placed under
57           t/ directory but are not directly used from .t files, too.  If
58           Test::Class family is used under t/, this option is implicitly set.
59
60       base_dir
61           Set the base directory from where "scan-perl-prereqs-nqlite" starts
62           traversing files and directories.
63
64       ignore
65           Set a list of paths "scan-perl-prereqs-nqlite" should ignore. This
66           is useful when your distribution has a set of OS-specific modules,
67           for example.
68
69       ignore_re
70           You can also specify a regexp instead of a list of paths. If this
71           is set, "ignore" options are ignored.
72
73       optional
74           Set a list of paths "scan-perl-prereqs-nqlite" should ignore. This
75           is useful when your distribution has a set of OS-specific modules,
76           for example.
77
78       optional_re
79           You can also specify a regexp instead of a list of paths. If this
80           is set, "optional" options are ignored.
81
82       private
83           Set a list of modules "scan-perl-prereqs-nqlite" should consider
84           private, that is, that are not uploaded to the CPAN. Contrary to
85           the "ignore" option, which makes the scanner skip scanning the
86           file, this option lets the scanner scan files, and excludes matched
87           prerequisites afterwards.
88
89       private_re
90           You can also specify a regexp instead of a list of modules. If this
91           is set, "private" options are ignored.
92
93       scan_also
94           Set a list of extra paths "scan-perl-prereqs-nqlite" should also
95           scan. This is useful when your application/distribution uses an
96           untraditional file layout.
97
98       feature
99             scan-perl-prereqs-nqlite \
100               --feature name:description:lib/My/Plugin/For/SpecificOS \
101               --feature name:description:web/lib,web/bin
102
103           Specify a feature name, a description, and matching paths.
104
105       use_index
106           You can specify an index name of CPAN::Common::Index module (such
107           as "Mirror" or "MetaDB") not to list all the modules of a required
108           distribution.
109
110       blib
111           If this is set, "scan-perl-prereqs-nqlite" will traverse
112           subdirectories under "blib" to collect runtime requirements.  It
113           may return better results if some of the files are located in some
114           uncommon places and/or some of them are listed in "no_index".
115           However, files in "blib" may be older than the ones under "lib"
116           etc, and you need to update them by running a make or a "Build"
117           script before you run "scan-perl-prereqs-nqlite".
118
119       parser
120           Set a list of parsers (or parser tags) "scan-perl-prereqs-nqlite"
121           uses. If this option is not set, the scanner uses ":installed"
122           parsers by default.
123
124       inc Add a list of additional @INC path "scan-perl-prereqs-nqlite" looks
125           for private parsers.
126
127       verbose
128           Print verbose messages.
129

AUTHOR

131       Kenichi Ishigaki, <ishigaki@cpan.org>
132

134       This software is copyright (c) 2015 by Kenichi Ishigaki.
135
136       This is free software; you can redistribute it and/or modify it under
137       the same terms as the Perl 5 programming language system itself.
138
139
140
141perl v5.36.0                      2022-07-22       SCAN-PERL-PREREQS-NQLITE(1)
Impressum