GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MODULE::BUILD::CONVERT (3)

.ds Aq ’

NAME

Module::Build::Convert - Makefile.PL to Build.PL converter

CONTENTS

SYNOPSIS



 use Module::Build::Convert;

 # example arguments (empty %args is sufficient too)
 %args = (Path => /path/to/perl/distribution(s),
          Verbose => 2,
          Use_Native_Order => 1,
          Len_Indent => 4);

 $make = Module::Build::Convert->new(%args);
 $make->convert;



DESCRIPTION

ExtUtils::MakeMaker has been a de-facto standard for the common distribution of Perl modules; Module::Build is expected to supersede ExtUtils::MakeMaker in some time (part of the Perl core as of 5.9.4).

The transition takes place slowly, as the converting process manually achieved is yet an uncommon practice. The Module::Build::Convert Makefile.PL parser is intended to ease the transition process.

CONSTRUCTOR

    new

Options:
o Path

Path to a Perl distribution. May point to a single distribution directory or to one containing more than one distribution. Default:

o Makefile_PL

Filename of the Makefile script. Default: Makefile.PL

o Build_PL

Filename of the Build script. Default: Build.PL

o MANIFEST

Filename of the MANIFEST file. Default: MANIFEST

o RC

Filename of the RC file. Default: .make2buildrc

o Dont_Overwrite_Auto

If a Build.PL already exists, output a notification and ask whether it should be overwritten. Default: 1

o Create_RC

Create a RC file in the homedir of the current user. Default: 0

o Parse_PPI

Parse the Makefile.PL in the PPI Parser mode. Default: 0

o Exec_Makefile

Execute the Makefile.PL via do Makefile.PL. Default: 0

o Verbose

Verbose mode. If set to 1, overridden defaults and skipped arguments are printed while converting; if set to 2, output of Verbose = 1 and created Build script will be printed. May be set via the make2build switches -v (mode 1) and -vv (mode 2). Default: 0

o Debug

Rudimentary debug facility for examining the parsing process. Default: 0

o Process_Code

Process code embedded within the arguments list. Default: 0

o Use_Native_Order

Native sorting order. If set to 1, the native sorting order of the Makefile arguments will be tried to preserve; it’s equal to using the make2build switch -n. Default: 0

o Len_Indent

Indentation (character width). May be set via the make2build switch -l. Default: 3

o DD_Indent

Data::Dumper indendation mode. Mode 0 will be disregarded in favor of 2. Default: 2

o DD_Sortkeys

Data::Dumper sort keys. Default: 1

METHODS

    convert

Parses the Makefile.PL’s WriteMakefile() arguments and converts them to Module::Build equivalents; subsequently the according Build.PL is created. Takes no arguments.

DATA SECTION

    Argument conversion

ExtUtils::MakeMaker arguments followed by their Module::Build equivalents. Converted data structures preserve their native structure, that is, HASH -> HASH, etc.



 NAME                  module_name
 DISTNAME              dist_name
 ABSTRACT              dist_abstract
 AUTHOR                dist_author
 VERSION               dist_version
 VERSION_FROM          dist_version_from
 PREREQ_PM             requires
 PL_FILES              PL_files
 PM                    pm_files
 MAN1PODS              pod_files
 XS                    xs_files
 INC                   include_dirs
 INSTALLDIRS           installdirs
 DESTDIR               destdir
 CCFLAGS               extra_compiler_flags
 EXTRA_META            meta_add
 SIGN                  sign
 LICENSE               license
 clean.FILES           @add_to_cleanup



    Default arguments

Module::Build default arguments may be specified as key/value pairs. Arguments attached to multidimensional structures are unsupported.



 #build_requires       HASH
 #recommends           HASH
 #conflicts            HASH
 license               unknown
 create_readme         1
 create_makefile_pl    traditional



Value may be either a string or of type SCALAR, ARRAY, HASH.

    Sorting order

Module::Build arguments are sorted as enlisted herein. Additional arguments, that don’t occur herein, are lower prioritized and will be inserted in unsorted order after preceedingly sorted arguments.



 module_name
 dist_name
 dist_abstract
 dist_author
 dist_version
 dist_version_from
 requires
 build_requires
 recommends
 conflicts
 PL_files
 pm_files
 pod_files
 xs_files
 include_dirs
 installdirs
 destdir
 add_to_cleanup
 extra_compiler_flags
 meta_add
 sign
 license
 create_readme
 create_makefile_pl



    Begin code

Code that preceeds converted Module::Build arguments.



 use strict;
 use warnings;

 use Module::Build;

 $MAKECODE

 my $b = Module::Build->new
 $INDENT(



    End code

Code that follows converted Module::Build arguments.



 $INDENT);

 $b->create_build_script;

 $MAKECODE



INTERNALS

co-opting CWWriteMakefile()

This behavior is no longer the default way to receive WriteMakefile()’s arguments; the Makefile.PL is now statically parsed unless one forces manually the co-opting of WriteMakefile().

In order to convert arguments, a typeglob from WriteMakefile() to an internal sub will be set; subsequently Makefile.PL will be executed and the arguments are then accessible to the internal sub.

    Data::Dumper

Converted ExtUtils::MakeMaker arguments will be dumped by Data::Dumpers Dump() and are then furtherly processed.

BUGS & CAVEATS

Module::Build::Convert should be considered experimental as the parsing of the Makefile.PL doesn’t necessarily return valid arguments, especially for Makefiles with bad or even worse, missing intendation.

The parsing process may sometimes hang with or without warnings in such cases. Debugging by using the appropriate option/switch (see CONSTRUCTOR/new) may reveal the root cause.

SEE ALSO

<http://www.makemaker.org>, ExtUtils::MakeMaker, Module::Build, <http://www.makemaker.org/wiki/index.cgi?ModuleBuildConversionGuide>

AUTHOR

Steven Schubiger <schubiger@cpan.org>

LICENSE

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

See <http://www.perl.com/perl/misc/Artistic.html>

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MODULE::BUILD::CONVERT (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.