NAME

distini-cpanfile - Dump cpanfile out of dist.ini

VERSION

This document describes version 0.001 of distini-cpanfile (from Perl distribution Module-CPANfile-FromDistINI), released on 2017-08-11.

SYNOPSIS

% distini-cpanfile > cpanfile

DESCRIPTION

This script dumps prerequisites information in Dist::Zilla's dist.ini. It gives a simple way to install a Dist::Zilla-based distribution from a source repository along with its dependencies. You don't have to install Dist::Zilla and do a dzil build first. When a source repository only contains dist.ini and no Makefile.PL or Build.PL or cpanfile, you still cannot use cpanm git://repo-url/Dist.git, but at least now you can git clone, cd to the source directory, run this script, and install the module using cpanm --installdeps.

This script is not perfect, because: 1) in Dist::Zilla prerequisites can be specified dynamically or from other sources (including a cpanfile :-), this script only parses [Prereqs/*] sections; 2) installing from source repository does not always work because source repository != built version, but in simple cases it can work.

As an alternative to installing from a source repository, to test things often you can also use:

% prove -l
% perl -I/path/to/source/repo/lib your-app.pl

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Module-CPANfile-FromDistINI.

SOURCE

Source repository is at https://github.com/perlancar/perl-Module-CPANfile-FromDistINI.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Module-CPANfile-FromDistINI

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

Dist::Zilla::Plugin::CPANFile can build cpanfile more properly, but this requires installing Dist::Zilla.

Module::CPANFile which contains scripts like mymeta-cpanfile.

scan-prereqs-cpanfile from App::scan_prereqs_cpanfile.

http://blogs.perl.org/users/piotr_roszatycki/2014/01/i-hate-distzilla-and-missing-makefilepl.html

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by perlancar@cpan.org.

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