Dist::...pender(3pm)

πŸ“¦
version 2.004 Β· 3 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

πŸ’… NAME πŸ’…

Dist::Zilla::Plugin::Prepender β€” ok bestie, this one prepends lines at the top of your perl files. Yes. That's the whole gig. And it slays.

(also the manual page shows up as Dist::...pender(3pm), from the User Contributed Perl Documentation set β€” you know, the little truncated-glam name πŸ’–)


✨ VERSION ✨

version 2.004 πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

so in your dist.ini you're gonna write this:

[Prepender]
copyright = 0
line = use strict;
line = use warnings;
skip = t/data/.+\.pl
skip = something-else-unnecessary

and that's it, that's the whole vibe ✨


🌸 DESCRIPTION 🌸

Okay so here's the tea: this plugin takes the lines you specify and prepends them into each Perl module or program inside your distribution. And for scripts that have a shebang line? The lines get inserted just after it β€” because obviously we're not gonna ruin a shebang, that would be a crime πŸ’€

Why would you even want this? Bestie, two reasons, both iconic:

  • enforcing a lil set of pragmas across all your files β€” and since pragmas are lexical, they'll be active for the whole file πŸͺ„
  • adding some copyright comments, which is what the fsf recommends πŸ‘‘

The module accepts the following options in its dist.ini section:

  • copyright β€” whether to insert a boilerplate copyright comment. defaults to true. βœ…
  • line β€” anything you want to add. may be specified multiple times. no default. πŸ“
  • skip β€” regexp of file names to not prepend to. may be specified multiple times. no default. πŸ™ˆ
fr fr, line and skip can show up over and over, and there's no default for either one β€” you gotta actually say what you want, bestie πŸ’…

πŸ”₯ SEE ALSO πŸ”₯

You can look for information on this module at:

  • Search CPAN

<http://search.cpan.org/dist/Dist-Zilla-Plugin-Prepender>

  • See open / report bugs

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Dist-Zilla-Plugin-Prepender>

  • Mailing-list (same as Dist::Zilla)

<http://www.listbox.com/subscribe/?list_id=139292>

  • Git repository

<http://github.com/jquelin/dist-zilla-plugin-prepender>

  • AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/Dist-Zilla-Plugin-Prepender>

  • CPAN Ratings

<http://cpanratings.perl.org/d/Dist-Zilla-Plugin-Prepender>


πŸ‘‘ AUTHOR πŸ‘‘

Jerome Quelin 🫢


This software is copyright (c) 2009 by Jerome Quelin.

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 was perl v5.36.0, dated 2022-10-13, and yes it's giving Dist::...pender(3pm) energy the whole way through 🌈⭐ mwah πŸ’‹

πŸ“¦ where this page comes from