NAME

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

VERSION

version 1.111750

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]
[CompileTests]
[CriticTests]
[MetaTests]
[PodCoverageTests]
[PodSyntaxTests]
[PodSpellingTests]
[KwaliteeTests]
[PortabilityTests]
[SynopsisTests]
[MinimumVersionTests]
[HasVersionTests]
[CheckChangesTests]
[DistManifestTests]
[UnusedVarsTests]
[NoTabsTests]
[EOLTests]
[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 CompileTests 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

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-PluginBundle-MARCEL.

AVAILABILITY

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 http://search.cpan.org/dist/Dist-Zilla-PluginBundle-MARCEL/.

The development version lives at http://github.com/hanekomu/Dist-Zilla-PluginBundle-MARCEL and may be cloned from git://github.com/hanekomu/Dist-Zilla-PluginBundle-MARCEL.git. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHORS

  • Marcel Gruenauer <marcel@cpan.org>

  • Jerome Quelin <jquelin@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Marcel Gruenauer.

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