-
-
25 Jul 2015 02:04:00 UTC
- Distribution: Dist-Zilla-Plugin-TaskWeaver
- Module version: 0.101628
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (4166 / 0 / 0)
- Kwalitee
Bus factor: 1- % Coverage
- License: perl_5
- Activity
24 month- Tools
- Download (17.13KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- Dist::Zilla
- Dist::Zilla::Plugin::PodWeaver
- Dist::Zilla::Role::FileGatherer
- Dist::Zilla::Role::PrereqSource
- Moose
- Pod::Elemental
- Pod::Elemental::Selectors
- Pod::Elemental::Transformer::Nester
- Pod::Weaver
- Pod::Weaver::Role::Dialect
- Pod::Weaver::Role::Section
- Test::More
- namespace::autoclean
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
Dist::Zilla::Plugin::TaskWeaver - a PodWeaver plugin used to build Task distributions
VERSION
version 0.101628
DESCRIPTION
The TaskWeaver plugin acts just like the PodWeaver plugin, but gets its claws just a bit into your Pod::Weaver configuration and then uses them to figure out prerequisites and grouping for building a Task distribution.
The
Task::
namespace is used for libraries that do not have any code of their own, but are just ways of getting a lot of other libraries installed at once. In other words, they're just prerequisites with no actual logic.TaskWeaver expects that your .pm file will have Pod like the following:
=pkgroup Modules That are Useful =pkg Sub::Exporter 0.901 first version with teeth =pkg Sub::Import =pkgroup Modules That are Useless =pkg Acme::ProgressBar 1.10
The
=pkgroup
directives start groups of prerequisites. You must have at least one=pkgroup
(although that may change). The=pkg
directives list specific directives, and are in the following format:=pkg Package::Name min_version reason
Both
min_version
andreason
are optional, although you can't give a reason without giving a version. If a reason is given, it will be included in the Pod to explain why the specific version is required.WARNING
TaskWeaver works, but relies on doing some pretty evil stuff. It may substantially change its method of operation in the future, but its expectations from your Pod should not change.
...AND ANOTHER THINGS
If you use three part versions, like
1.2.3
, you will want to require a very modern ExtUtils::MakeMaker, probably v6.68 or later. You can do that with:[Prereqs / EUMM] -phase = configure -type = requires ExtUtils::MakeMaker = 6.68
Placeholder Testfile
Due to the way various CPAN clients install modules, it is necessary to generate a fake testfile so there is at least a test in the distribution.
If you do not want to generate the file, disable the
placeholder_test
attribute.[TaskWeaver] placeholder_test = 0
AUTHOR
Ricardo Signes <rjbs@cpan.org>
CONTRIBUTORS
Apocalypse <APOCAL@cpan.org>
Glenn Fowler <cebjyre@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by Ricardo Signes.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Dist::Zilla::Plugin::TaskWeaver, copy and paste the appropriate command in to your terminal.
cpanm Dist::Zilla::Plugin::TaskWeaver
perl -MCPAN -e shell install Dist::Zilla::Plugin::TaskWeaver
For more information on module installation, please visit the detailed CPAN module installation guide.