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