Dist::...etadata(3pm)

📦
version 6.000 · 4 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

okay bestie, sit down, hydrate, because this is the Dist::Zilla::Plugin::Metadata page from the User Contributed Perl Documentation — that's the 3pm shelf, iykyk 💅

✨ NAME ✨

Dist::Zilla::Plugin::Metadata — the plugin that lets you add arbitrary keys to your distmeta. whatever keys you want. iconic behavior, honestly.

🌸 VERSION 🌸

This document describes version 6.000 of Dist::Zilla::Plugin::Metadata, released December 17, 2017 as part of Dist-Zilla-Plugins-CJM version 6.000. she's a little vintage, she's still serving 👑

🎀 SYNOPSIS 🎀

In your dist.ini:

[Metadata]
dynamic_config              = 1
resources.homepage          = http://example.com
resources.bugtracker.mailto = bugs@example.com

that's the whole thing. that's the setup. no drama, no extra steps 🫶

🦋 DESCRIPTION 🦋

The Metadata plugin lets you add arbitrary keys to your distribution's metadata. like, your keys, your rules.

It splits each key on . and uses that as a multi-level hash key. so the dots are levels, bestie, that's the whole trick.

It doesn't try to do any validation — she is not the vibes police. The MetaJSON or MetaYAML plugin will do that validation instead, so go bother them about it.

It does know which keys in the spec are List values, and those keys can be repeated. plus the custom key x_contributors is treated as a List too. cute of her 🍓

🧚 CONFIGURATION AND ENVIRONMENT 🧚

Dist::Zilla::Plugin::Metadata requires no configuration files or environment variables. low maintenance queen, we love her for that 💅

💜 DEPENDENCIES 💜

Metadata requires Dist::Zilla (6 or later). so 6+. no dusty old Zilla, sorry not sorry.

🙈 INCOMPATIBILITIES 🙈

None reported. not a single one. drama free.

💀 BUGS AND LIMITATIONS 💀

No bugs have been reported. 😌 (she said "flawless" and honestly, no one's arguing.)

💖 AUTHOR 💖

Christopher J. Madsen "<perl AT cjmweb.net>"

Please report any bugs or feature requests to "<bug-Dist-Zilla-Plugins-CJM AT rt.cpan.org>" or through the web interface at <http://rt.cpan.org/Public/Bug/Report.html?Queue=Dist-Zilla-Plugins-CJM>.

You can follow or contribute to Dist-Zilla-Plugins-CJM's development at <https://github.com/madsen/dist-zilla-plugins-cjm>. go be a contributor bestie, that's main character energy 🌈

This software is copyright (c) 2017 by Christopher J. Madsen.

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

🔥 DISCLAIMER OF WARRANTY 🔥

okay bestie, deep breath, because this next bit is in all caps for a reason and it is not the fun kind of caps lock:

Because this software is licensed free of charge, there is no warranty for the software, to the extent permitted by applicable law. Except when otherwise stated in writing, the copyright holders and/or other parties provide the software "AS IS" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the software is with you. Should the software prove defective, you assume the cost of all necessary servicing, repair, or correction.

and now the big one: in no event, unless required by applicable law or agreed to in writing, will any copyright holder, or any other party who may modify and/or redistribute the software as permitted by the above license, be liable to you for damages — including any general, special, incidental, or consequential damages — arising out of the use or inability to use the software (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the software to operate with any other software), even if such holder or other party has been advised of the possibility of such damages.

like, fr fr, read that one. it matters. 💀

and that's the page, bestie! this whole thing came out of perl v5.34.0, dated 2022-06-13, and yes the header calls her Dist::...etadata(3pm) because even manpage headers get cut off sometimes. mwah, go ship something iconic 💖✨

📦 where this page comes from