/ 
Dist-Zilla-Plugin-MetaProvides-Package-1.15000003
River stage two • 50 direct dependents • 78 total dependents
/ Dist::Zilla::Plugin::MetaProvides::Package

NAME

Dist::Zilla::Plugin::MetaProvides::Package - Extract namespaces/version from traditional packages for provides

VERSION

version 1.15000003

SYNOPSIS

In your dist.ini:

[MetaProvides::Package]
inherit_version = 0    ; optional
inherit_missing = 0    ; optional
meta_noindex    = 1    ; optional

CONSUMED ROLES

Dist::Zilla::Role::MetaProvider::Provider

ROLE SATISFYING METHODS

provides

A conformant function to the Dist::Zilla::Role::MetaProvider::Provider Role.

signature: $plugin->provides()

returns: Array of Dist::Zilla::MetaProvides::ProvideRecord

ATTRIBUTES

finder

This attribute, if specified will

  • Override the FileFinder used to find files containing packages

  • Inhibit autovivification of the .pm file finder

This parameter may be specified multiple times to aggregate a list of finders

PRIVATE ATTRIBUTES

_package_blacklist

_finder_objects

PRIVATE METHODS

_packages_for

signature: $plugin->_packages_for( $filename, $file_content )

returns: Array of Dist::Zilla::MetaProvides::ProvideRecord

_vivify_installmodules_pm_finder

_build_finder_objects

_found_files

OPTIONS INHERITED FROM Dist::Zilla::Role::MetaProvider::Provider

inherit_version

How do you want existing versions ( Versions hard-coded into files before running this plug-in )to be processed?

  • DEFAULT: inherit_version = 1

    Ignore anything you find in a file, and just probe DZIL->version() for a value. This is a sane default and most will want this.

  • inherit_version = 0

    Use this option if you actually want to use hard-coded values in your files and use the versions parsed out of them.

inherit_missing

In the event you are using the aforementioned "inherit_version" = 0, this determines how to behave when encountering a module with no version defined.

  • DEFAULT: inherit_missing = 1

    When a module has no version, probe DZIL->version() for an answer. This is what you want if you want to have some files with fixed versions, and others to just automatically be maintained by Dist::Zilla.

  • inherit_missing = 0

    When a module has no version, emit a versionless record in the final metadata.

meta_noindex

This is a utility for people who are also using MetaNoIndex, so that its settings can be used to eliminate items from the 'provides' list.

  • meta_noindex = 0

    By default, do nothing unusual.

  • DEFAULT: meta_noindex = 1

    When a module meets the criteria provided to MetaNoIndex, eliminate it from the metadata shipped to Dist::Zilla

SEE ALSO

AUTHOR

Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Kent Fredric.

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