NAME

App::makefilepl2cpanfile - Convert Makefile.PL to a cpanfile automatically

SYNOPSIS

use App::makefilepl2cpanfile;

# Generate a cpanfile string
my $cpanfile_text = App::makefilepl2cpanfile::generate(
	makefile	=> 'Makefile.PL',
	existing	=> '',		# optional, existing cpanfile content
	with_develop => 1,			# include developer dependencies
);

# Write to disk
open my $fh, '>', 'cpanfile' or die $!;
print $fh $cpanfile_text;
close $fh;

DESCRIPTION

This module parses a `Makefile.PL` and produces a `cpanfile` with:

• Runtime dependencies (`PREREQ_PM`)

• Build, test, and configure requirements (`BUILD_REQUIRES`, `TEST_REQUIRES`, `CONFIGURE_REQUIRES`)

• Optional author/development dependencies in a `develop` block

The parsing is done **safely**, without evaluating the Makefile.PL.

CONFIGURATION

You may create a YAML file in:

~/.config/makefilepl2cpanfile.yml

with a structure like:

develop:
  Perl::Critic: 0
  Devel::Cover: 0
  Test::Pod: 0
  Test::Pod::Coverage: 0

This will override the default development tools.

METHODS

generate(%args)

Generates a cpanfile string.

Arguments:

• makefile

  Path to `Makefile.PL`. Defaults to `'Makefile.PL'`.

• existing

  Optional string containing an existing cpanfile. Existing `develop` blocks are merged.

• with_develop

  Boolean. Include default or configured author tools. Defaults to true if not overridden.

Returns the cpanfile as a string.

SUPPORT

This module is provided as-is without any warranty.

AUTHOR

Nigel Horne <njh@nigelhorne.com>

LICENCE AND COPYRIGHT

Copyright 2025 Nigel Horne.

Usage is subject to licence terms.

The licence terms of this software are as follows:

• Personal single user, single computer use: GPL2

• All other users (including Commercial, Charity, Educational, Government) must apply in writing for a licence for use from Nigel Horne at the above e-mail.