The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

scan-prereqs-cpanfile - Scan prerequisite modules and generate CPANfile

SYNOPSIS

% scan-prereqs-cpanfile

    --diff=META.json      # Generate diff from META.json
    --diff=cpanfile       # Generate diff from cpanfile
    --ignore=extlib
    --dir=/foo/bar
    --scan-test-requires

DESCRIPTION

This script scans prerequisite modules from your code, and generate CPANfile. You can also list missing prerequisite modules.

SCANNING RULES

Used modules in `Build.PL` or `Makefile.PL` as 'test' requires
Used modules in `t/` as 'test' requires
Used modules in `xt/`, `benchmark/` and `author/` as 'develop' requires
Used modules in other directories as 'runtime' requires

OPTIONS

--diff
--diff=META.json      # Generate diff from META.json
--diff=cpanfile       # Generate diff from cpanfile

Compare the scanning result with META.json, META.yml or cpanfile. With this option, scan-prereqs-cpanfile displays missing prerequisite modules only.

--ignore
--ignore=tools,extlib

Ignore some directories.

--ignore-file
--ignore-file=ignored.regex

Ignore all files and directories matching a regex pattern listed in this file.

--include-empty

By default, phases without any prereqs are not dumped, By giving this option, cpanfile will have an empty block such as:

on test => sub {

};

Defaults to false.

--scan-test-requires

Scan test files and include the modules specified by Test::Requires as 'develop' requires.

--dir
--dir=DIRECTORY

Scan for modules in DIRECTORY (instead of '.')

AUTHOR

Tokuhiro Matsuno

SEE ALSO

Module::CPANfile, Perl::PrereqScanner::Lite