Ricardo SIGNES > Dist-Zilla-Plugin-TaskWeaver > Dist::Zilla::Plugin::TaskWeaver

Download:
Dist-Zilla-Plugin-TaskWeaver-0.101626.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.101626   Source  

NAME ^

Dist::Zilla::Plugin::TaskWeaver - a PodWeaver plugin used to build Task distributions

VERSION ^

version 0.101626

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 and reason 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.

AUTHOR ^

Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2013 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.

syntax highlighting: