NAME

scan-perl-prereqs-nqlite

SYNOPSIS

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

DESCRIPTION

scan-perl-prereqs-nqlite traverses several files and subdirectories in the current directory with File::Find to collect all .pl, .PL, .pm, .t, .psgi files (as well as all the files in scripts? and bin directories), and prints a single combined list of prerequisites, which should be suitable for piping to cpanm or similar tools.

You can also pass files and/or directories to limit files to scan. In this case, however, scan-perl-prereqs-nqlite doesn't try to exclude modules that should belong to the same distribution.

OPTIONS

version

Show the version.

help

Show this help.

json

Print prerequisites as a JSON if JSON::PP is installed.

cpanfile, save_cpanfile

Print prerequisites as cpanfile if Module::CPANfile is installed. If safe-cpanfile is set, create or update cpanfile.

suggests

Print suggestions (used modules in eval) as well.

develop

Print requirements/suggestions for developers (used modules in xt, inc, and author directories) as well.

exclude_core

Ignore prerequisites that are bundled in the Perl core (of 5.008001 by default). This requires Module::CoreList version 2.99 or above.

perl_version

Ignore prerequisites that are bundled in the Perl core of specific version. This implies exclude-core as well.

allow_test_pms

Print requirements/suggestions in .pm files that are placed under t/ directory but are not directly used from .t files, too. If Test::Class family is used under t/, this option is implicitly set.

base_dir

Set the base directory from where scan-perl-prereqs-nqlite starts traversing files and directories.

ignore

Set a list of paths scan-perl-prereqs-nqlite should ignore. This is useful when your distribution has a set of OS-specific modules, for example.

ignore_re

You can also specify a regexp instead of a list of paths. If this is set, ignore options are ignored.

use_index

You can specify an index name of CPAN::Common::Index module (such as "Mirror" or "MetaDB") not to list all the modules of a required distribution.

blib

If this is set, scan-perl-prereqs-nqlite will traverse subdirectories under blib to collect runtime requirements. It may return better results if some of the files are located in some uncommon places and/or some of them are listed in no_index. However, files in blib may be older than the ones under lib etc, and you need to update them by running a make or a Build script before you run scan-perl-prereqs-nqlite.

AUTHOR

Kenichi Ishigaki, <ishigaki@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Kenichi Ishigaki.

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