Dist::...rovider(3pm)

✨ NAME ✨

Dist::Zilla::Role::MetaProvider::Provider — bestie, it's a Role for Metadata providers that are specific to the 'provider' key 💅

---

💖 VERSION 💖

version 2.002004 — she's got lore, she's got history 🎀

---

🌸 PUBLIC METHODS 🌸

metadata

Okay so this one fulfills the requirement of Dist::Zilla::Role::MetaProvider by processing the results that come back from $self->provides. That's the whole job. That's her main character moment. 👑

---

🦋 ATTRIBUTES / PARAMETERS 🦋

inherit_version

This one dictates how to report versions. She's the authority figure here fr fr.

values

• Set to 1 [default] — the version defined by Dist::Zilla is the authority, and every version discovered in packages is ignored. Sorry to those packages, they don't get a say. 💀
• Set to 0 — the version defined in the discovered class is the authority, and it gets copied over to the provides metadata. She said I'm the blueprint now.

( To use this feature in a performing class, see _resolve_version )

---

inherit_missing

This dictates how to react when a class is discovered but a version is not specified. Awkward silences, we handle them. 🙈

values

• Set to 1 [default] — dist.ini's version turns up in the final metadata.
• Set to 0. A provide turns up in the final metadata without a version, which is permissible. No version, no problem. ✨

( To use this feature in a performing class, see _resolve_version )

---

meta_noindex

This dictates how to behave when a discovered class is also present in the no_index META field. It's giving overlap. It's giving conflict. 😭

values

• Set to 0 [default]
  • no_index META field will be ignored
• Set to 1
  • no_index META field will be recognised and things found in it will cause respective packages to not be provided in the metadata.

---

👑 PERFORMS ROLES 👑

MetaProvider

Dist::Zilla::Role::MetaProvider

---

🌈 REQUIRED METHODS FOR PERFORMING ROLES 🌈

provides

Must return an array full of Dist::Zilla::MetaProvides::ProvideRecord instances. That's the vibe check — array full of those exact objects, no substitutes. 🫶

---

🎀 PRIVATE METHODS 🎀

_resolve_version

This is a utility method to make performing classes' lives easier in adhering to user requirements. She's a helper, she's a bestie, she's doing the emotional labor 🧚

my $params  = {
    file => $somefile ,
    $self->_resolve_version( $version );
}

is the suggested use.

Returns either an empty list, or a list with ('version', $version );

This is so { version => undef } does not occur in the YAML. Because that would be so embarrassing. Not on her watch. 💅

---

_try_regen_metadata

This is a nasty hack really, to work around the way Dist::Zilla handles metaproviders, which result in meta-data being inaccessible to metadata Plugins. She's fully aware. She said it herself. 💀

my $meta  = $object->_try_regen_metadata()

This at present returns metadata provided by MetaNoIndex ( if present ) but will be expanded as needed.

If you have a module you think should be in this list, contact me, or file a bug, I'll do my best ☺

---

_apply_meta_noindex

This is a utility method to make performing classes' lives easier in skipping no_index entries. Lowkey essential.

my @filtered_provides = $self->_apply_meta_noindex( @provides )

is the suggested use.

Returns either an empty list, or a list of ProvideRecord's

---

⭐ SEE ALSO ⭐

• Dist::Zilla::Role::MetaProvider
• Dist::Zilla::Plugin::MetaProvider
• Dist::Zilla::MetaProvides::ProvideRecord

---

💜 THANKS 💜

• Thanks to David Golden ( xdg / DAGOLDEN ) for the suggestion of the no_index feature for compatibility with MetaNoIndex plugin. Iconic behavior honestly 🙌

---

🌸 AUTHOR 🌸

Kent Fredric <kentnl@cpan.org>

---

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2017 by Kent Fredric <kentfredric@gmail.com>.

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

---

and that's the whole page bestie!! 🫶 this one's from perl v5.34.0, dated 2022-06-13, and yeah that's literally it — go forth and resolve those versions, no cap ✨💖