The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Dist::Zilla::PluginBundle::MARCEL - Build and release a distribution like MARCEL

VERSION

version 1.121330

SYNOPSIS

In your dist.ini:

    [@MARCEL]
    major_version = 1          ; this is the default
    weaver        = pod        ; default, can also be 'task'
    skip_prereq   = ::Test$    ; no default

DESCRIPTION

This is a plugin bundle to load all plugins that I am using. It is equivalent to:

    [AutoVersion]

    ; -- fetch & generate files
    [GatherDir]
    [Test::Compile]
    [Test::Perl::Critic]
    [MetaTests]
    [PodCoverageTests]
    [PodSyntaxTests]
    [Test::PodSpelling]
    [Test::Kwalitee]
    [Test::Portability]
    [Test::Synopsis]
    [Test::MinimumVersion]
    [HasVersionTests]
    [Test::CheckChanges]
    [Test::DistManifest]
    [Test::UnusedVars]
    [NoTabsTests]
    [Test::EOL]
    [InlineFilesMARCEL]
    [ReportVersions]

    ; -- remove some files
    [PruneCruft]
    [PruneFiles]
    filenames = dist.ini

    [ManifestSkip]

    ; -- get prereqs
    [AutoPrereq]

    ; -- gather metadata
    [Repository]
    [Bugtracker]
    [Homepage]

    ; -- munge files
    [ExtraTests]
    [NextRelease]
    [PkgVersion]
    [CopyReadmeFromBuild]
    [PodWeaver]
    config_plugin = '@MARCEL'

    ; -- dynamic meta-information
    [ExecDir]
    [ShareDir]
    [MetaProvides::Package]

    ; -- generate meta files
    [License]
    [MakeMaker]
    [MetaYAML]
    [MetaJSON]
    [ReadmeFromPod]
    [InstallGuide]
    [Manifest] ; should come last

    ; -- release
    [CheckChangeLog]
    [@Git]
    [UploadToCPAN]

The following options are accepted:

  • major_version - passed as major option to the AutoVersion plugin. Default to 1.

  • weaver - can be either pod (default) or task, to load respectively either PodWeaver or TaskWeaver.

  • weaver_finder - a multi-value argument that overrides the default file finders used by PodWeaver.

  • skip_prereq - passed as skip option to the AutoPrereq plugin if set. No default.

  • fake_home - passed to Test::Compile to control whether to fake home.

METHODS

mvp_multivalue_args

Defines that weaver_finder is a multi-value argument.

bundle_config

Defines the bundle's contents and passes on this bundle's configuration to the individual plugins as described above.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS

You can make new bug reports, and view existing ones, through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-PluginBundle-MARCEL.

AVAILABILITY

The project homepage is http://search.cpan.org/dist/Dist-Zilla-PluginBundle-MARCEL/.

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/Dist::Zilla::PluginBundle::MARCEL/.

AUTHORS

  • Marcel Gruenauer <marcel@cpan.org>

  • Jerome Quelin <jquelin@cpan.org>

  • Olivier Mengue <dolmen@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Olivier Mengué.

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

1 POD Error

The following errors were encountered while parsing the POD:

Around line 204:

Non-ASCII character seen before =encoding in 'Mengué'. Assuming UTF-8