Kent Fredric > Dist-Zilla-Plugin-MetaData-BuiltWith > Dist::Zilla::Plugin::MetaData::BuiltWith

Download:
Dist-Zilla-Plugin-MetaData-BuiltWith-0.03000101.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.03000101   Source   Latest Release: Dist-Zilla-Plugin-MetaData-BuiltWith-1.000000

NAME ^

Dist::Zilla::Plugin::MetaData::BuiltWith - Report what versions of things your distribution was built against

VERSION ^

version 0.03000101

SYNOPSIS ^

  [MetaData::BuiltWith]
  include = Some::Module::Thats::Not::In::Preq
  exclude = Some::Module::Youre::Ashamed::Of
  show_uname = 1           ; default is 0
  show_config = 1          ; default is 0
  uname_call = uname        ; the default
  uname_args = -s -r -m -p  ; the default is -a

DESCRIPTION ^

Often, distribution authors get module dependencies wrong. So in such cases, its handy to be able to see what version of various packages they built with.

Some would prefer to demand everyone install the same version as they did, but that's also not always necessary.

Hopefully, the existence of the metadata provided by this module will help users on their end machines make intelligent choices about what modules to install in the event of a problem.

OPTIONS ^

exclude

Specify modules to exclude from version reporting

    exclude = Foo
    exclude = Bar

include

Specify additional modules to include the version of

    include = Foo
    include = Bar

show_config

Report "interesting" values from %Config::Config

    show_config = 1 ; Boolean

show_uname

Report the output from uname

    show_uname = 1 ; Boolean

uname_call

Specify what the system uname function is called

    uname_call = uname ; String

uname_args

Specify arguments passed to the uname call.

    uname_args = -a ; String

METHODS ^

mvp_multivalue_args

This module can take, as parameters, any volume of 'exclude' or 'include' arguments.

metadata

This module scrapes together the name of all modules that exist in the "Prereqs" section that Dist::Zilla collects, and then works out what version of things you have, applies the various include/exclude rules, and ships that data back to Dist::Zilla via this method. See Dist::Zilla's MetaProvider role for more details.

EXAMPLE OUTPUT ( META.json ) ^

    "x_BuiltWith" : {
       "modules" : {
          "Dist::Zilla::Role::MetaProvider" : "4.101612",
          "File::Find" : "1.15",
          "File::Temp" : "0.22",
          "Module::Build" : "0.3607",
          "Moose" : "1.07",
          "Test::More" : "0.94"
       },
       "perl" : "5.012000",
       "platform" : "MSWin32"
    },

AUTHOR ^

Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2013 by Kent Fredric <kentnl@cpan.org>.

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: